Twilio MCP Server logo

Twilio MCP Server

Expose Twilio messaging, voice, phone number, Studio, and other public APIs to MCP-compatible AI tools.

Install Twilio MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "twilio-labs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @twilio-alpha/mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked .

Overview

Twilio MCP Server connects MCP-compatible AI assistants to Twilio's public APIs, including messaging, voice, phone numbers, and Studio. It authenticates with a Twilio Account SID plus API key and secret, then exposes API operations as MCP tools. Use service and tag filters to limit the APIs available to an assistant and reduce context usage. The official Twilio Labs server is suited to agent workflows that need to inspect or manage Twilio resources through natural-language tool calls.

Use cases

  • Send messages through Twilio from an AI-assisted workflow
  • Manage voice-related Twilio resources with MCP tools
  • Work with Twilio phone numbers through a conversational agent
  • Operate selected Twilio Studio APIs while limiting exposed services

Key features

  • Exposes Twilio public APIs as MCP tools
  • Supports messaging, voice, phone numbers, and Studio
  • Authenticates with an Account SID, API key, and API secret
  • Filters APIs by service or tag
  • Runs from npx using a standard MCP configuration

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · @twilio-alpha/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars114Stargazers on the source repository.
npm downloads6.6kPackage downloads in the last 30 days.
Last commit9mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.

How Twilio MCP Server works

What Twilio MCP Server does

Twilio MCP Server makes Twilio's public APIs available through the Model Context Protocol. AI assistants and other MCP clients can use the exposed tools to work with Twilio capabilities such as messaging, voice, phone numbers, and Studio, along with other public Twilio services.

The repository is organized as a monorepo. Its main mcp package provides the server for Twilio's public API, while a separate openapi-mcp-server package can serve an OpenAPI specification supplied by the user. The Twilio-focused package is the relevant choice when an agent needs access to Twilio's APIs.

How it works

The server runs as a standard command-line MCP process. A client starts it with npx, passes the Twilio credentials as an argument, and communicates with the process over the client's MCP connection. The example configuration uses the @twilio-alpha/mcp package.

Credentials are supplied in this format:

text
ACCOUNT_SID/API_KEY:API_SECRET

The server turns selected Twilio API operations into MCP tools that an assistant can call. Because exposing every API can create a large tool and context surface, the server supports narrowing the exposed set by service or tag.

Setup and configuration

Add a server entry to an MCP client's configuration and replace the placeholder credentials with a Twilio Account SID, API key, and API secret:

config.json
{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp",
        "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
      ]
    }
  }
}

Twilio's API key and secret are created or located through Twilio's API key management documentation. The server also accepts --services and --tags options to filter which APIs it exposes. Use these options when the client has limited context capacity or when an agent only needs a defined part of Twilio.

Tools and capabilities

Available capabilities include:

  • Exposing Twilio's public APIs as MCP tools
  • Working with messaging APIs
  • Working with voice APIs
  • Accessing phone number APIs
  • Accessing Twilio Studio APIs
  • Filtering exposed APIs by service or tag
  • Running through an npx-based stdio configuration

The exact tool set depends on the services and tags selected at startup. API version selection may also matter when an operation is available across multiple Twilio API versions.

Limitations and notes

The project is identified as an alpha release, so teams should evaluate it before using it for production-critical automation. Twilio API credentials and permissions must be valid, and the credential argument must follow the expected format.

Loading all available APIs may exceed an AI model's context limits. Restricting the server with --services or --tags helps keep the exposed tool set manageable. Twilio also recommends avoiding community MCP servers alongside its official servers when those servers could access the same Twilio account, reducing the chance of untrusted systems reaching account data or tools.

The project is licensed under ISC. Its repository includes commands for running tests and linting during development.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Twilio MCP Server

Twilio MCP Server is an MCP server that connects AI assistants and other MCP clients to Twilio's public APIs. Its tools cover services including messaging, voice, phone numbers, and Studio. It authenticates with a Twilio Account SID, API key, and API secret, and can filter exposed APIs by service or tag.

Run it through npx in your MCP client's server configuration. Set the command to npx, pass -y and @twilio-alpha/mcp, then provide credentials in the ACCOUNT_SID/API_KEY:API_SECRET format.

Use the --services and --tags startup options to select the APIs exposed as tools. Filtering the server can reduce context usage when an assistant only needs particular Twilio services.

It requires a Twilio Account SID, API key, and API secret. Pass them as one command-line argument in the format ACCOUNT_SID/API_KEY:API_SECRET, and ensure the credentials have the permissions required by the requested API operations.

It can expose Twilio's public APIs, but using service or tag filters is recommended when context limits are a concern. Loading a narrower API set keeps the tool surface more manageable for an AI assistant.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTwilio MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/twilio-labs-mcp?style=directory)](https://allmcps.com/mcp/twilio-labs-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/twilio-labs-mcp"><img src="https://allmcps.com/api/badge/twilio-labs-mcp?style=directory" alt="Twilio MCP Server on AllMCPs" /></a>