How to connect AgentPhone to Claude

Connect Claude Web, Desktop and Cowork to AgentPhone MCP. Send appointment reminders through agentphone, review recent agentphone voice call transcripts, and more using natural language, with authentication handled for you.

AgentPhone logoAgentPhone
Api Key

AgentPhone is a communications platform for AI-powered phone numbers, voice calls, messaging, and WhatsApp. It helps you manage agent conversations, contacts, webhooks, and usage from one place.

76 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your AgentPhone account to Claude via Composio Connect, enabling it to send appointment reminders through AgentPhone, review recent AgentPhone voice call transcripts, create contacts from AgentPhone conversations, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate AgentPhone with

Connecting AgentPhone to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your AgentPhone account

Back in Claude, ask it to connect to AgentPhone or give it any AgentPhone-related task.

For example, ask Claude to:

  • "Send appointment reminders through AgentPhone"
  • "Review recent AgentPhone voice call transcripts"
  • "Create contacts from AgentPhone conversations"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your AgentPhone account is ready to use.

What is the AgentPhone Claude Connector, and what's possible with it?

The AgentPhone MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your AgentPhone account. It provides structured and secure access to your phone numbers, voice agents, calls, conversations, webhooks, WhatsApp connections, and usage data, so your agent can manage voice agents, inspect calls and transcripts, configure communications, and monitor account activity on your behalf.

  • Voice agent and call management: Have your agent create, review, and delete voice agents, start browser call sessions, inspect active or completed calls, end calls, and download recordings.
  • Call transcripts and contact details: Let the agent retrieve full call transcripts, examine transcript events, create or remove contacts, and check whether a phone number supports iMessage, SMS, or RCS.
  • WhatsApp and communications setup: Direct your agent to connect or disconnect WhatsApp numbers, create or delete WhatsApp templates, manage conversations, and configure recipient-visible contact cards.
  • Webhooks and integrations: Instruct your agent to create, update, inspect, or remove webhooks, review delivery statistics, and check or disconnect the AgentPhone Supabase integration.
  • Usage and account operations: Have your agent review message, call, SMS, and webhook usage, analyze trends and breakdowns, manage sub-accounts and SIP trunks, and check phone number locations or registration status.

Troubleshooting

1. Why does Claude not use the Composio connector for AgentPhone?

The connector can show as connected, but Claude must use it in each AgentPhone conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to AgentPhone again.

2. Why does Claude show an MCP server error before AgentPhone connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for AgentPhone.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect AgentPhone.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the AgentPhone authorization link not work?

The Composio connector is one server. Your AgentPhone account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the AgentPhone connection.
  • Composio creates a fresh AgentPhone authorization link.
  • Open that link in your browser and finish the AgentPhone sign-in.

4. Why do AgentPhone actions fail after they worked before?

The AgentPhone connection can expire or lose permission.

  • Ask Claude to inspect the AgentPhone connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the AgentPhone account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in AgentPhone.
  • If the action still fails with a permission error, check that the connected account has that permission in AgentPhone itself.

5. How do I switch to a different AgentPhone account?

Claude can manage the AgentPhone connection for you.

  • Ask Claude to disconnect or delete the current AgentPhone account.
  • Ask Claude to connect AgentPhone again.
  • Open the new Composio authorization link for AgentPhone.
  • Sign in with the other AgentPhone account in the browser.
  • After the account connects, ask Claude to retry the AgentPhone task.

6. Why is my AgentPhone connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your AgentPhone connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If AgentPhone tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect AgentPhone.
TOOLS

Supported Tools

Every AgentPhone action and event your agent gets out of the box.

Check Verification

Check a recipient-provided six-digit code against a pending verification.

Complete WhatsApp Connection

Complete Meta Embedded Signup using a caller-supplied short-lived code.

Configure Webhook

Create or update the account webhook or one agent override.

Connect WhatsApp Number

Register one existing WABA phone number for Meta Cloud API use and bind it to AgentPhone, optionally attaching an agent.

Create Agent

Create a webhook-mode or hosted AI voice agent.

Create Contact

Create an AgentPhone contact from a phone number and name.

Create SIP Trunk

Create a SIP trunk with provider-generated routing.

Create Sub-Account

Create an AgentPhone sub-account with the supplied name.

Create Web Call

Create a browser-call session and return a secret access token that expires in 30 seconds.

Create WhatsApp Template

Submit either authored components or one Meta Template Library entry to a connected WABA.

Delete Agent

Permanently delete an AgentPhone agent.

Delete Contact

Permanently delete one saved AgentPhone contact.

Delete Contact Card

Permanently remove the recipient-visible iMessage contact card from an owned AgentPhone number.

Delete SIP Trunk

Permanently delete a SIP trunk, remove its upstream routing, and soft-delete its local record.

Delete Sub-Account

Permanently delete an AgentPhone sub-account and all isolated tenant state associated with it.

Delete Webhook

Delete the account webhook and stop account delivery, or delete an agent override so that agent falls back to the account webhook.

Delete WhatsApp Template

Permanently delete a Meta WhatsApp template.

Disconnect Supabase

Permanently disconnect the AgentPhone account's existing Supabase integration.

Disconnect WhatsApp

Permanently disconnect a WhatsApp Business Account from AgentPhone and release its AgentPhone numbers.

Download Call Recording

Download the complete WAV recording for a completed AgentPhone call as a file.

End Call

Immediately request termination of an active AgentPhone call.

Get Agent

Get one AgentPhone agent by ID with its voice configuration and attached numbers.

Get Call

Get full status, timing, metadata, and transcript details for one AgentPhone call by ID.

Get Call Transcript

Read the complete stored transcript for a completed or in-progress call.

Get Call Transcript Events

Download up to 1 MB of SSE events for a completed AgentPhone call as a file.

Get Contact

Get one saved AgentPhone contact by its stable contact ID.

Get Contact Capabilities

Run a live check, without sending a message, for the current iMessage, SMS, and RCS reachability of a phone number.

Get Contact Card

Get the recipient-visible iMessage contact card currently configured for one owned AgentPhone number.

Get Conversation

Get one conversation by ID with participants, channel state, capabilities, and up to 100 recent messages.

Get Location

Get the provider's current latitude, longitude, status, and last-update timestamp for one known phone number.

Get Number

Get one owned AgentPhone number by ID, including active or released records, with its status and channel configuration.

Get Registration Details

Read submitted A2P 10DLC brand and campaign content exactly as exposed for review.

Get Registration Status

Read the current A2P 10DLC campaign status, processing stage, provider message, and resolved sub-account.

Get SIP Trunk

Get one SIP trunk by ID with routing, transfer, encryption, URI, and allowed-IP settings.

Get Supabase Status

Check whether the AgentPhone account has an authenticated Supabase integration and return non-secret project or account metadata.

Get Usage

Get current account quotas, reporting-period bounds, and message, call, SMS segment, and webhook activity totals and rolling windows.

Get Usage Breakdown

Break down usage by owned phone number or by agent.

Get Usage Trends

Get message, call, and webhook usage as either daily or monthly time-series points.

Get Webhook

Get the account webhook or one agent's override without exposing its signing secret.

Get Webhook Delivery Stats

Get detailed recent webhook delivery health or lightweight all-time aggregate counts.

Get WhatsApp Status

Inspect whether WhatsApp is enabled and connected and return the account's AgentPhone WhatsApp connection IDs.

List Agents

List AI voice agents and their current voice, mode, configuration, and attached numbers.

List Calls

List calls account-wide, for one agent, or for one owned number.

List Contacts

Search and list saved contacts used in messaging workflows.

List Conversations

List account-wide or agent-scoped messaging conversations with participants, channels, latest activity, and message counts.

List Messages

Read one newest-first page of message history for either a conversation or an owned phone number.

List Numbers

List owned AgentPhone numbers with routing, agent assignment, SMS registration, and channel status.

List SIP Trunks

List SIP trunks and their routing, transfer, encryption, URI, and IP configuration.

List Sub-Accounts

List isolated sub-accounts with optional recent activity statistics.

List Voices

List a bounded prefix of voice IDs and metadata available for hosted AgentPhone agents.

List Webhook Deliveries

List one page of account-wide deliveries or the bounded recent deliveries for one agent.

List WhatsApp Numbers

List phone numbers available on a connected WhatsApp Business Account and show which are already connected to AgentPhone.

List WhatsApp Templates

List and filter a connected WhatsApp Business Account's message templates, including their language variants and Meta approval status.

Lookup Numbers

Look up line type, country, and RCS intelligence before messaging up to 25 phone numbers.

Place Call

Immediately place one externally visible, metered outbound telephone call from an AgentPhone agent to a consented destination.

Provision Number

Purchase and provision an AgentPhone number, optionally choosing an area code and attaching an agent.

Refresh Locations

Request one asynchronous refresh of account location data.

Refresh Supabase Token

Retrieve a valid Supabase credential server-side, refreshing AgentPhone's stored provider credential when needed.

Release Number

PERMANENTLY AND IRREVERSIBLY release an owned AgentPhone number from its upstream provider and mark it released.

Search Available Numbers

Search unreserved US or Canadian phone-number inventory before provisioning a number.

Send Message

Send one externally visible and potentially billed SMS, MMS, iMessage, RCS-routed, or WhatsApp message.

Send Reaction

Send one externally visible iMessage tapback or supported custom emoji reaction to an existing message.

Send Typing Indicator

Show a short-lived, externally visible typing indicator in a one-to-one or group iMessage conversation.

Send Verification

Send an external SMS containing a non-configurable six-digit code that expires after 10 minutes and allows at most three checks.

Set Agent Number Assignment

Attach an owned phone number to an agent or detach it, changing which agent handles that number.

Set Contact Card

Create or fully replace the recipient-visible iMessage contact card for an owned number.

Start Supabase Connection

Create a one-shot, short-lived Supabase OAuth bootstrap and return a secret connect URL.

Submit A2P Registration

Submit legal business, campaign, consent, and sample-message information for external US carrier A2P 10DLC review.

Test Webhook

Send one externally observable fake message payload to the account webhook or an agent override.

Update A2P Registration

Submit selected changes to an existing A2P 10DLC registration for external carrier review.

Update Agent

Update one or more selected fields of an existing voice agent.

Update Chat Background

Set or remove the recipient-visible custom background for an iMessage chat.

Update Contact

Update explicitly supplied fields of an existing AgentPhone contact.

Update Conversation

Replace a conversation's stored agent context and/or rename an iMessage group.

Update SIP Trunk

Update selected display, transfer, or inbound origination settings on an existing SIP trunk.

Update Sub-Account

Rename an existing AgentPhone sub-account.

FRAMEWORKS

How to build AgentPhone MCP Agent with another framework

FAQ

Frequently asked questions

Start with AgentPhone.It takes 30 seconds.

Managed auth, hosted MCP servers, and every AgentPhone tool your agent needs.Free to start.

Start building