SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Saperly MCP to Claude

Connect Claude Web, Desktop and Cowork to Saperly MCP. List active saperly phone numbers, review saperly call usage this month, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Saperly MCP logoSaperly MCP
Api Key

Saperly MCP is an official MCP server for managing Saperly phone numbers, connections, calls, SMS, and usage. It gives developers scoped workspace access through a single API key.

24 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 Saperly account to Claude via Composio Connect, enabling it to list active Saperly phone numbers, review Saperly call usage this month, send an SMS from your Saperly number, 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.

Also integrate Saperly MCP with

ChatGPTHermesAtomic Agent

Connecting Saperly 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 Saperly account

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

For example, ask Claude to:

  • "List active Saperly phone numbers"
  • "Review Saperly call usage this month"
  • "Send an SMS from your Saperly number"

It will prompt you to authenticate and authorize access.

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

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

The Saperly MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Saperly account. It provides structured and secure access to your phone numbers, connections, calls, SMS, voices, and usage, so your agent can manage numbers, configure call handlers, place calls, send messages, and review communication activity on your behalf.

  • Phone number management: Have your agent search available numbers, provision new lines, list current numbers, assign connections, set caller ID names, configure SMS sender names, or release numbers.
  • Call handling and control: Let the agent list and retrieve calls, place outbound calls, speak into live calls, and transfer active calls to a phone number or SIP address.
  • Connection setup: Direct your agent to create, update, sync, list, retrieve, or delete Saperly connections, including changing their mode and call instructions.
  • SMS communication: Instruct your agent to send SMS messages from your Saperly numbers and review messages, including messages associated with a specific number.
  • Voice and usage monitoring: Have your agent list available voices and private custom voices, then check workspace call, message, and balance usage.

Troubleshooting

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

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

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

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

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

  • 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 Saperly.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Saperly authorization link not work?

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

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

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

The Saperly connection can expire or lose permission.

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

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

Claude can manage the Saperly connection for you.

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

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

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

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Saperly 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 Saperly.
TOOLS

Supported Tools

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

Assign number connection

Attach a connection (the handler that answers calls) to a number — i.

Create connection

Create a connection.

Delete connection

Delete a connection.

Get call

Fetch one call record by its Saperly id.

Get connection

Fetch one connection by its Saperly id.

Get number

Fetch one phone number by its Saperly id.

Get usage

Summarize calls, messages, and the current balance for this workspace.

List calls

List the calls in this workspace.

List connections

List the connections (call/message handlers) configured in this workspace.

List custom voices

List this workspace’s private voices and their processing status.

List messages

List SMS messages in this workspace, optionally filtered to one number.

List numbers

List the active phone numbers (lines) provisioned in this workspace.

List voices

List stock voices and ready private voices.

Place call

Dial an outbound call from one of your numbers.

Provision number

Order a new phone number and add it to this workspace.

Release number

Release a phone number and stop billing it.

Search available numbers

Search available inventory for numbers available to provision, priced for this workspace.

Send sms

Send an SMS from one of your numbers.

Set caller id name

Set (or clear) a line’s outbound CALLER ID NAME — the 1–15 letter/number/space display name (CNAM) shown alongside the number on the called party’s phone.

Set sms sender

Set (or clear) a line’s alphanumeric SMS sender name — the 1–11 letter/number label recipients see as the “from” on INTERNATIONAL SMS only.

Speak into call

Speak a line into a live call.

Sync connection

Reconcile a connection — create/update its assistant and mint its manual-mode secret.

Transfer call

Blind-transfer a live call to another destination — an E.

Update connection

Update a connection’s name, instructions, compliance/disclosure — or switch its mode between hosted (an in-network AI assistant) and manual (your own brain via BYO-LLM).

FRAMEWORKS

How to build Saperly MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Saperly MCP with ChatGPT

Hermes logo

Hermes

Use Saperly MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Saperly MCP with Atomic Agent

FAQ

Frequently asked questions

With a standalone Saperly MCP server, the agents and LLMs can only access a fixed set of Saperly tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Saperly and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Saperly tools.

Yes, absolutely. You can configure which Saperly scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Saperly data and credentials are handled as safely as possible.

Start with Saperly MCP.It takes 30 seconds.

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

Start building