Skip to content

MCP server

Twilio MCP server

Twilio's MCP servers: a hosted docs server in public beta for searching Twilio documentation, and an alpha server that exposes Twilio APIs.

At a glance

Maintained by
Twilio
Tools exposed
2 listed below
Reviewed
September 24, 2026

Why it matters

What it does and why it matters

Twilio powers SMS, voice calls, WhatsApp messages and verification for many businesses. It offers two MCP options. The hosted docs server, in public beta, lets an assistant search and retrieve Twilio documentation. A separate alpha server exposes Twilio's APIs, so an assistant can work with messages, numbers and other resources.

For developers, the docs server makes building Twilio features faster. The API server opens the door to assistants that send reminders or check message status.

The API server generates its tools from Twilio's API specifications, and its tool names are not listed in the docs, so we show only the docs server tools here. The API server is an alpha release. Anything that sends messages or makes calls costs money and reaches real people, so we use restricted API keys, test numbers and approval steps.

Use cases

Best business use cases

Build faster

Answer Twilio questions from current docs while coding.

Appointment reminders

Send approved SMS reminders. See appointment scheduling.

Message status

Check whether messages were delivered.

Voice setups

Get help configuring voice flows.

Verification

Learn and test verification flows.

Tools

Available tools

Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.

Read and write: Docs server is read-only. The API server can read and write (send SMS, manage numbers, Studio, Serverless) filtered by --services and --tags.

  • twilio__search

    Search Twilio, SendGrid and Segment API docs in plain language (docs server).

  • twilio__retrieve

    Get full parameter and response schemas for an API (docs server).

Workflows

Example workflows

Build an SMS reminder feature

  1. 1

    A developer asks how to send scheduled SMS.

  2. 2

    The assistant searches Twilio docs.

  3. 3

    It returns the right API and example.

  4. 4

    The developer builds the feature.

  5. 5

    Tests run with test credentials.

Check failed messages

  1. 1

    Ask about failed messages today.

  2. 2

    The API server lists them.

  3. 3

    The assistant groups errors by cause.

  4. 4

    It links to the docs for each error.

  5. 5

    The team fixes the cause.

Prompts

Example prompts

  • “Search the Twilio docs for how to schedule an SMS for tomorrow morning.”

  • “What does Twilio error 30007 mean and how do we fix it?”

  • “Show the steps to set up phone verification.”

Setup

Installation and configuration

Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.

Claude Desktop: claude_desktop_config.json

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

Claude Code: terminal

claude mcp add --transport http twilio-docs https://mcp.twilio.com/docs
  • Hosted server: https://mcp.twilio.com/docs (docs search only).
  • Local server: npm: @twilio-alpha/mcp (full Twilio API as tools).
  • Needs: Docs server: none. API server: Account SID plus API Key and Secret passed as ACCOUNT_SID/API_KEY:API_SECRET..

Security

Security considerations

  • Approve outgoing messages

    Require a person to approve messages to customers until a workflow is proven.

  • Limit channels

    Give access only to the channels, mailboxes or numbers a task needs.

  • Untrusted messages

    Incoming messages can contain text meant to mislead an AI. Treat them as data.

  • Keep a log

    Use restricted API keys and test numbers, and log every message sent.

Related servers

Servers that pair well with it

Resend

Resend's official MCP server lets AI send emails and batches, read sent and received mail, manage contacts, send broadcasts and verify domains.

Slack

Slack's own hosted MCP server lets AI search messages, read channels and threads, look up people, draft or send messages and create canvases.

Google Calendar

Google's own Calendar MCP server lets AI list calendars and events, create, update and delete events, respond to invites and suggest times.

Keep exploring

FAQ

Questions people ask us

Have a question that is not here? Ask us directly.

Start a project

Want this connected to your own systems? We build AI workflows with MCP.

Send a short brief. We reply with questions, a suggested plan and an estimate you can compare with other offers.

Your privacy choices

We use necessary storage to run this site. With your permission we also use Google Analytics to see which pages help people, and load maps from Google. You can change this at any time. Read the cookie policy.