X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Telnyx to Claude

Connect Claude Web, Desktop and Cowork to Telnyx MCP. Check current telnyx account balance, list recent audit logs for last week, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Telnyx logoTelnyx
Api Key

Telnyx is a communications platform offering voice, SMS, and data services on a global private network. It empowers businesses to automate messaging, calls, and notifications at scale.

30 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 Telnyx account to Claude via Composio Connect, enabling it to check current Telnyx account balance, list recent audit logs for last week, create new SMS notification channel, 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 Telnyx with

OpenAI Agents SDKClaude Agent SDKClaude CodeCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

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

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

For example, ask Claude to:

  • "Check current Telnyx account balance"
  • "List recent audit logs for last week"
  • "Create new SMS notification channel"

It will prompt you to authenticate and authorize access.

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

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

The Telnyx MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Telnyx account. It provides structured and secure access to your Telnyx communications platform, so your agent can manage networks, handle notification channels, monitor usage, and review account activities on your behalf.

  • Network provisioning and management: Easily create or delete network resources, allowing your agent to spin up new networks or remove unused ones as needed.
  • Notification channel automation: Set up, configure, or remove notification channels—including SMS, voice, email, or webhook endpoints—so your agent can handle event-driven communications flexibly.
  • Notification profile and settings control: Group and configure notification profiles and settings, enabling your agent to define how and when notifications are delivered for different events.
  • Real-time balance monitoring: Retrieve your current account balance and credit details, helping your agent keep tabs on usage and alert you before credits run low.
  • Comprehensive audit log access: Review detailed audit logs so your agent can surface recent changes, track resource modifications, and help maintain compliance or troubleshoot issues quickly.

Troubleshooting

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

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

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

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

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

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

3. Why does the Telnyx authorization link not work?

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

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

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

The Telnyx connection can expire or lose permission.

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

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

Claude can manage the Telnyx connection for you.

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

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

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

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

Supported Tools

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

Create Network

Tool to create a new network.

Create Notification Channel

Tool to create a notification channel.

Create Notification Profile

Tool to create a notification profile.

Create Notification Setting

Tool to add a notification setting.

Delete Network

Tool to delete a network by ID.

Delete Notification Channel

Tool to delete a notification channel by ID.

Delete Notification Profile

Tool to delete a notification profile by ID.

Delete Notification Setting

Tool to delete a notification setting by ID.

Get Black Box Test Results

Tool to retrieve black box test results from Telnyx SETI Observability.

Get User Balance

Tool to retrieve the current user account balance and credit details.

List Audit Logs

Tool to retrieve a list of audit log entries for your account.

List Connections

Tool to retrieve all connections in your account.

List Dynamic Emergency Endpoints

Tool to list dynamic emergency endpoints.

List Global IP Health Check Types

Tool to list all available global IP health check types.

List Messaging Profiles

Tool to list messaging profiles.

List Messaging URL Domains

Tool to list configured messaging URL domains.

List Mobile Network Operators

Tool to list available mobile network operators.

List Network Interfaces

Tool to list all network interfaces for a specified network.

List Networks

Tool to list all networks in your account.

List Notification Channels

Tool to list all notification channels.

List Notification Event Conditions

Tool to list all notification event conditions.

List Notification Events

Tool to list all notification events with their IDs.

List Notification Profiles

Tool to list all notification profiles.

List Phone Numbers

Tool to list phone numbers associated with your account.

List SSO Authentication Providers

Tool to retrieve all configured SSO authentication providers.

Retrieve Network

Tool to retrieve details of a specific network by ID.

Retrieve Notification Channel

Tool to retrieve a notification channel by ID.

Retrieve Notification Profile

Tool to retrieve a notification profile by ID.

Retrieve Notification Setting

Tool to retrieve a notification setting by ID.

Update Network

Tool to update details of an existing network.

FRAMEWORKS

How to build Telnyx MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Telnyx MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Telnyx MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Telnyx MCP with Claude Code

Codex logo

Codex

Use Telnyx MCP with Codex

OpenClaw logo

OpenClaw

Use Telnyx MCP with OpenClaw

Hermes logo

Hermes

Use Telnyx MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Telnyx MCP with Atomic Agent

Google ADK logo

Google ADK

Use Telnyx MCP with Google ADK

LangChain logo

LangChain

Use Telnyx MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Telnyx MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Telnyx MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Telnyx MCP with LlamaIndex

CrewAI logo

CrewAI

Use Telnyx MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Telnyx MCP with Pydantic AI

AutoGen logo

AutoGen

Use Telnyx MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Telnyx MCP server, the agents and LLMs can only access a fixed set of Telnyx tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Telnyx 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 Telnyx tools.

Yes, absolutely. You can configure which Telnyx 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 Telnyx data and credentials are handled as safely as possible.

Start with Telnyx.It takes 30 seconds.

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

Start building