twilio-mcp-server

Twilio MCP

An MCP server for Twilio communications. Send SMS, MMS, and WhatsApp messages. Make voice calls. Manage phone numbers.

What it does

Connect your Twilio account to any MCP client. Send text messages, share images, make phone calls, and manage your phone numbers through natural language.

Tools

• send_sms. Send an SMS text message.
• send_mms. Send an MMS message with an image or media file.
• send_whatsapp. Send a WhatsApp message.
• get_message_status. Check delivery status of a sent message.
• list_messages. View recent message history with filters.
• make_call. Initiate a voice call with TwiML control.
• list_calls. View recent call history.
• list_numbers. List your Twilio phone numbers.
• search_numbers. Search available phone numbers by area code.

Authentication

Set these environment variables:

export TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export TWILIO_AUTH_TOKEN="your-auth-token"

Find these in your Twilio Console dashboard.

Install

npx twilio-mcp

Claude Desktop setup

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": ["-y", "twilio-mcp"],
      "env": {
        "TWILIO_ACCOUNT_SID": "ACxxxxxxxx",
        "TWILIO_AUTH_TOKEN": "your-token"
      }
    }
  }
}

Example usage

Ask Claude:

"Send an SMS to [phone] saying 'Hello from Claude' from my Twilio number"

"Send a WhatsApp message to [phone] with this image attached"

"What is the delivery status of message SM1234567890?"

"List my recent messages from the last day"

"Call [phone] and play a message using this TwiML URL"

"List my Twilio phone numbers"

"Search for available phone numbers in area code 415"

Voice calls

To make calls, you need a TwiML URL that controls the call flow. You can use TwiML Bin in the Twilio Console or host your own TwiML. Example TwiML:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Say voice="alice">Hello, this is a call from your AI assistant.</Say>
</Response>

License

MIT