> ## Documentation Index
> Fetch the complete documentation index at: https://support.callin.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Callin for Claude

> Let Claude place real phone calls for you and review your voice agents, calls and transcripts.

The Callin connector lets Claude place real phone calls on your behalf with your Callin voice agents, and read your agents, call history and transcripts. It works in Claude on the web, on desktop and in the mobile apps.

## What you can do

* **Make a call for you** — "Call +39 06 1234 5678 and book a table for two tomorrow at 8 pm, name Rossi." Claude confirms the number and the goal with you, a Callin agent makes the call in the right language, and you get the outcome, a summary and the transcript in the chat.
* **Follow a call** — "How did the call go?" Claude checks the status and reports back when the call ends.
* **Review your calls** — "Show my latest inbound calls", "Summarize yesterday's call with +44…", "Find calls of my Reception agent this week."
* **Check your agents** — "Show my Callin agents."

Once connected, Claude has these tools:

| Tool | What Claude uses it for |
| - | - |
| **List Callin agents** / **Get Callin agent** | See your agents and the details of one agent |
| **List Callin calls** / **Get Callin call** | See your call history and the details of one call |
| **Search Callin calls** | Find calls by agent, date, direction or phone number |
| **Read Callin transcript** | Read what was said in a call |
| **Get phone call status** | Follow a call while it is in progress |
| **Place a phone call** | Make a call for you, only after you approve it |

More questions you can ask:

* "Show my latest 10 calls."
* "Summarize my latest customer call."
* "Show my inbound calls from today."
* "Find calls handled by my sales agent this week."

## Requirements

* A Callin account ([app.callin.io](https://app.callin.io)).
* A Claude account (web, desktop or mobile app).
* For calls: an outbound agent with a phone number (an agent named "Task Caller" is used first), a Callin API key and available minutes.

You'll find your API key in Callin, in your **Profile → API Keys** ([open it](https://app.callin.io/profile?subSection=api)). If it says "No API key found", click **Regenerate Key** to create one.

![Callin Profile page on the API Keys tab, with the Regenerate Key button, the security notice and the API key field showing No API key found](https://mintcdn.com/lechusai/BCy-NI5cPX9bD_xS/images/claude-api-keys.png?fit=max\&auto=format\&n=BCy-NI5cPX9bD_xS\&q=85\&s=bcddec874e7917eaae8e202b6aab8646)

Screenshot: Profile → API Keys, where you create and copy your Callin API key.

## Connect

You can start from Claude or from Callin. Both ways end on the same Callin consent screen.

### From Claude

**Step 1**

In Claude, open **Customize → Connectors**.

**Step 2**

Find **Callin** and click **Connect**. If Callin isn't listed yet, click **Add → Add custom connector**, enter the name **Callin** and the URL `https://claude-mcp.callin.io/mcp`, click **Add**, and then **Connect**.

**Step 3**

Sign in to Callin if asked, and click **Allow access** on the consent screen.

**Step 4**

Start a new chat and ask Claude to call someone or about your calls.

### From Callin

**Step 1**

In Callin, go to **Actions** and click **Connect** on the **Claude** card. The **Claude × Callin** page opens.

**Step 2**

Under **Callin connector URL**, click **Copy URL**.

**Step 3**

Click **Connect Claude**. Claude opens in a new tab.

**Step 4**

In Claude, open **Customize → Connectors**, click **Add → Add custom connector**, and paste the URL. Then click **Add** and **Connect**.

**Step 5**

Click **Allow access** on the Callin consent screen.

<video autoPlay muted loop playsInline src="https://mintcdn.com/lechusai/BCy-NI5cPX9bD_xS/images/claude-connect.mp4?fit=max&auto=format&n=BCy-NI5cPX9bD_xS&q=85&s=e7848ee0030e2986d7d7af745f45cfc1" />

Video: Actions → Claude card → Callin connector URL → consent screen → Connected.

This is the connector URL block on the **Claude × Callin** page:

![Callin connector URL block showing https://claude-mcp.callin.io/mcp and the Copy URL button](https://mintcdn.com/lechusai/BCy-NI5cPX9bD_xS/images/claude-connector-url.png?fit=max\&auto=format\&n=BCy-NI5cPX9bD_xS\&q=85\&s=0aee8cce94851b253faf907781abb3b4)

Screenshot: The Callin connector URL with the Copy URL button.

The consent screen lists everything Claude will be able to do in your Callin account, including placing phone calls (billed per minute). Access lasts up to 30 days, or until you disconnect.

![Connect Claude to Callin consent screen with Client: Claude, the requested permissions (account information, AI agents, calls, call transcripts, placing phone calls with your outbound agents, access for up to 30 days) and the Allow access and Cancel buttons](https://mintcdn.com/lechusai/BCy-NI5cPX9bD_xS/images/claude-consent.png?fit=max\&auto=format\&n=BCy-NI5cPX9bD_xS\&q=85\&s=ed55de6cecd5c5c7d7b41a6072aca8f7)

Screenshot: The Callin consent screen. Click Allow access to connect.

> [!TIP]
>
> The consent screen also offers **Use an API key instead**. Use it only if you want to connect a different Callin account from the one you are signed in with: paste that account's API key and Claude connects to it.

Once connected, the **Claude × Callin** page in Callin shows **Connected**, the access you authorized, and a **Disconnect Claude** button:

![Claude × Callin page with the Connected status, the list of what you can do, the Connect Claude, Learn more and Disconnect Claude buttons, and the authorized access](https://mintcdn.com/lechusai/BCy-NI5cPX9bD_xS/images/claude-connected.png?fit=max\&auto=format\&n=BCy-NI5cPX9bD_xS\&q=85\&s=df6a0a5eebe12eb93ad67b5f44b30cbe)

Screenshot: The Claude × Callin page after connecting.

### Choose when Claude can use each tool

In Claude, open **Customize → Connectors → Callin** to see the connector's tools, grouped as read-only tools and write tools (**Place a phone call**). By default, each one needs your approval: the first time Claude wants to use a tool in a chat, it asks you, and you can allow it once or always.

> [!NOTE]
>
> Keep **Place a phone call** on approval, so that no call is placed without your OK.

## How calls work

> [!NOTE]
>
> Claude always asks you to approve a call before it is placed.

* The agent opens every call by saying it is an AI assistant calling on behalf of a customer.
* Supported call languages: Italian, English, Spanish, French, German, Portuguese and Dutch.
* Only full international numbers (for example +39…, +44…, +1…) can be called. Emergency and short numbers cannot.
* At most 10 calls per hour per account. Calls use your Callin minutes like any other call.
* Calls are recorded and transcribed as in your Callin account, and appear in your Callin call history.

## Privacy and security

* Claude only sees the agents and calls of your own Callin account (or your team's).
* Claude never receives your API key, agent prompts or billing data, and cannot change agents or settings.
* Transcripts may contain what the other person said; Claude treats them as information, never as instructions.
* See the [Callin privacy policy](https://callin.io/legal-pages/privacy-policy).

## Disconnect

Remove the connector in Claude (**Customize → Connectors → Callin → Disconnect**) or in Callin (**Actions → Claude → Disconnect Claude**). Existing tokens stop working immediately.

## Troubleshooting

| Message | What to do |
| - | - |
| "Phone calls need a Callin API key" | Create one in Callin → Profile → API Keys, then try again. |
| "No outbound Callin agent with a phone number" | Create an outbound agent and assign it a number. |
| "Call limit reached" | Wait up to an hour; the limit is 10 calls per hour. |
| The call fails right away | Check that the agent's number is active and that you have minutes left. |
| Callin doesn't appear in Claude's connector list | Use **Add custom connector** with the URL `https://claude-mcp.callin.io/mcp`. |
| Claude says you have no agents or calls | The connector may be connected to another Callin account. Disconnect it and connect again with the right account. |
| "Connection request expired" on the consent screen | Start the connection again from Claude. If it keeps happening, check that your browser isn't blocking cookies. |

## Support

Write to [support@callin.io](mailto:support@callin.io).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.