MCP Directory

How to add Twilio MCP Server (Twilio Alpha) to Claude Desktop

Official Twilio MCP exposing Twilio's public API — SMS, voice, messaging and more Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 105★ · stdio · apikey · official

Claude Desktop config for Twilio MCP Server (Twilio Alpha)

npx -y @twilio-alpha/mcp <ACCOUNT_SID>/<API_KEY>:<API_SECRET>
{
  "mcpServers": {
    "twilio-mcp-server-twilio-alpha": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp",
        "<ACCOUNT_SID>/<API_KEY>:<API_SECRET>"
      ]
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Twilio MCP Server (Twilio Alpha) config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Twilio MCP Server (Twilio Alpha)'s tools appear under the 🔌 tools menu.

Before you start

  • Node.js 18+ and npm 9+ (run via npx, no global install needed)
  • An active Twilio account
  • A Twilio Account SID (starts with AC…) from the Twilio Console
  • A Twilio API Key SID and Secret created in Console under Account > API keys & tokens (IAM)

What Twilio MCP Server (Twilio Alpha) can do in Claude Desktop

Messaging / SMS APIs

Send and manage SMS/MMS and messaging services (e.g. twilio_messaging_v1, Api20100401Message)

Voice APIs

Create and manage calls and voice resources via the Voice/Api endpoints

Conversations APIs

Manage conversations, participants and messages (twilio_conversations_v1)

Studio APIs

Trigger and manage Studio flow executions (StudioV2Flow)

TaskRouter APIs

Manage workspaces, workers, tasks and queues

Serverless APIs

Manage Functions/Assets services and deployments (twilio_serverless_v1)

Phone Number APIs

List and manage incoming phone numbers (Api20100401IncomingPhoneNumber)

Verify APIs

Start and check Verify OTP verifications and services

Security

Uses a Twilio API key/secret that can send billable SMS/voice and modify account resources, so use a restricted API key and scope the server to specific services. Credentials are passed as a CLI argument and may appear in process listings — prefer running in an isolated environment.

Twilio MCP Server (Twilio Alpha) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Twilio MCP Server (Twilio Alpha) config there under the "mcpServers" key and restart the client.

Is Twilio MCP Server (Twilio Alpha) safe to use with Claude Desktop?

Uses a Twilio API key/secret that can send billable SMS/voice and modify account resources, so use a restricted API key and scope the server to specific services. Credentials are passed as a CLI argument and may appear in process listings — prefer running in an isolated environment.

How do I authenticate?

Pass your credentials as ACCOUNT_SID/API_KEY:API_SECRET on the command line. Create the API Key and Secret in the Twilio Console under Account > API keys & tokens; the Account SID is on your Console dashboard.

Why do I have to use --services and --tags?

Twilio's full API is too large to expose as tools at once and would exhaust the model's context. The flags let you load only the service groups and endpoint tags you actually need.

Is this maintained by Twilio?

Yes, it is published by Twilio Alpha (twilio-labs) under the @twilio-alpha/mcp package and MIT license. Twilio describes it as an alpha / proof of concept.

View repo Full Twilio MCP Server (Twilio Alpha) page