Twilio

by Twilio

v0.7.0

MIT

Repository Docs npm

Developer Tools

smsvoicemessagingtwilio

Summary

Twilio Labs' MCP server — send messages, place calls, and manage numbers across the Twilio API.

Features

Send SMS and place calls from an AI client
Manage phone numbers and messaging services
Access the full Twilio API surface through one server

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "Twilio" tools will be available.

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp"
      ],
      "env": {
        "TWILIO_ACCOUNT_SID": "ACxxxxx",
        "TWILIO_API_KEY": "SKxxxxx",
        "TWILIO_API_SECRET": "your-secret"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add twilio -e TWILIO_ACCOUNT_SID=ACxxxxx -e TWILIO_API_KEY=SKxxxxx -e TWILIO_API_SECRET=your-secret -- npx -y @twilio-alpha/mcp

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp"
      ],
      "env": {
        "TWILIO_ACCOUNT_SID": "ACxxxxx",
        "TWILIO_API_KEY": "SKxxxxx",
        "TWILIO_API_SECRET": "your-secret"
      }
    }
  }
}

Cursor

{
  "command": "npx",
  "args": [
    "-y",
    "@twilio-alpha/mcp"
  ],
  "env": {
    "TWILIO_ACCOUNT_SID": "ACxxxxx",
    "TWILIO_API_KEY": "SKxxxxx",
    "TWILIO_API_SECRET": "your-secret"
  }
}

Windsurf

{
  "command": "npx",
  "args": [
    "-y",
    "@twilio-alpha/mcp"
  ],
  "env": {
    "TWILIO_ACCOUNT_SID": "ACxxxxx",
    "TWILIO_API_KEY": "SKxxxxx",
    "TWILIO_API_SECRET": "your-secret"
  }
}

VS Code

{
  "command": "npx",
  "args": [
    "-y",
    "@twilio-alpha/mcp"
  ],
  "env": {
    "TWILIO_ACCOUNT_SID": "ACxxxxx",
    "TWILIO_API_KEY": "SKxxxxx",
    "TWILIO_API_SECRET": "your-secret"
  }
}

Description

Twilio Labs' MCP server exposes the Twilio API to an AI assistant, covering messaging, voice, and account management.

What it can do

Messaging — send SMS and WhatsApp messages, and inspect message history and delivery status
Voice — place calls and retrieve call records and recordings
Phone numbers — search available numbers, purchase them, and configure webhooks
Messaging services and sender pools
Account resources — subaccounts, usage records, and API keys

Because it is generated from Twilio's OpenAPI specifications, coverage extends across the API surface rather than a hand-picked subset, and it can be scoped to specific services to keep the tool list manageable.

Realistic uses

Prototyping a notification flow, debugging why a message failed by reading its status and error code, bulk-configuring webhook URLs across numbers, and looking up call records without opening the console.

Important caution

Sending messages and placing calls costs money and reaches real people. Use API key credentials rather than the account auth token, and be deliberate about giving an assistant send permissions.

Runs with npx -y @twilio-alpha/mcp.