MCP Directory

Twilio MCP Server (Twilio Alpha)

Official

Official Twilio MCP exposing Twilio's public API — SMS, voice, messaging and more

Verified
stdio (local)
API key
TypeScript
View repo 105 Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
npx -y @twilio-alpha/mcp <ACCOUNT_SID>/<API_KEY>:<API_SECRET>

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

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)

About Twilio MCP Server (Twilio Alpha)

The official Twilio MCP server (from Twilio Alpha / Twilio's ETI team) that exposes Twilio's public REST APIs to AI assistants over MCP. Instead of hand-writing one tool per endpoint, it generates MCP tools dynamically from Twilio's OpenAPI specifications, so a wide surface of Twilio operations — Messaging/SMS, Voice, Conversations, Studio, TaskRouter, Serverless, Verify and more — becomes callable.

Because Twilio's full API surface is huge and would blow past an LLM's context window, the server is meant to be filtered down. You pass --services to load only certain API groups (e.g. twilio_messaging_v1, twilio_serverless_v1) and --tags to narrow to specific endpoint groups within a service. This keeps the exposed tool list small and relevant.

It runs locally over stdio via npx -y @twilio-alpha/mcp and authenticates with your Twilio Account SID plus an API Key/Secret pair. The repo is a monorepo that also ships an openapi-mcp-server package for turning any OpenAPI spec into an MCP server. Twilio labels this project alpha/proof-of-concept.

Tools & capabilities (8)

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

When to use it

  • Use it when you want an assistant to send SMS or look up message logs through Twilio
  • Use it when you need to place or inspect voice calls programmatically from an agent
  • Use it when managing Conversations, Studio flows, or TaskRouter tasks from natural language
  • Use it when buying or configuring Twilio phone numbers or running Verify OTP checks
  • Use it when you want to scope the agent to only specific Twilio products via --services/--tags
  • Use it when prototyping Twilio automation without hand-coding API tool wrappers

Quick setup

  1. 1Create an API Key/Secret in the Twilio Console (Account > API keys & tokens)
  2. 2Run npx -y @twilio-alpha/mcp YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET
  3. 3Add --services and/or --tags flags to load only the Twilio products you need
  4. 4Add that command to your MCP client config (Claude Desktop, Cursor, etc.) and restart the client
  5. 5Verify by asking the assistant to list available Twilio tools or send a test SMS

Security notes

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) FAQ

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.

What does the openapi-mcp-server package do?

It is a separate package in the same monorepo that turns any OpenAPI specification (via --apiPath) into an MCP server — the Twilio server is built on top of it.

Does it run remotely or locally?

It runs locally over stdio via npx, so your Twilio credentials stay on your machine and are passed directly to the process.

#twilio#sms#voice#messaging#official

Alternatives to Twilio MCP Server (Twilio Alpha)

WhatsApp MCP Server (lharries)
Communication
5.7k

Connect your personal WhatsApp: search, read and send messages and media locally

Verified
stdio (local)
No auth
Python
12 tools
Updated 26 days agoRepo
Slack MCP Server (korotovsky)
Communication
1.7k

Powerful Slack MCP with stdio/SSE/HTTP, DMs, group DMs and no-admin token auth

Verified
stdio (local)
API key
Go
12 tools
Updated 1 month agoRepo
Telegram MCP Server (chigwell)
Communication
1.2k

Full Telegram user-account MCP via MTProto: read chats, manage groups, send messages

Verified
stdio (local)
API key
Python
11 tools
Updated 7 days agoRepo

Compare Twilio MCP Server (Twilio Alpha) with:

vs WhatsApp MCP Server (lharries)vs Slack MCP Server (korotovsky)vs Telegram MCP Server (chigwell)vs Gmail MCP Server (GongRzhe)