Twilio MCP Server

A Model Context Protocol (MCP) server that enables Claude and other AI assistants to send SMS and MMS messages using Twilio.

Demo

Features

• Send SMS messages 📱
• Pre-built prompts for common messaging scenarios 📝
• Secure handling of Twilio credentials 🔒

Example Interactions with Claude

Here are some natural ways to interact with the server through Claude:

1. Simple SMS:

Send a text message to the number +11234567890 saying "Don't forget about dinner tonight!"

2. Creative SMS:

Write a haiku about autumn and send it to my number +11234567890

Important Notes

1. Phone Number Format: All phone numbers must be in E.164 format (e.g., +11234567890)
2. Rate Limits: Be aware of your Twilio account's rate limits and pricing
3. Security: Keep your Twilio credentials secure and never commit them to version control

Security

Please do not include any sensitive information (like phone numbers or Twilio credentials) in GitHub issues or pull requests.

Requirements

• Node.js >= 18
  • If you need to update Node.js, we recommend using nvm (Node Version Manager):
    Copy

    nvm install 18.14.2
    nvm alias default 18.14.2

  • If you encounter any errors in Claude Desktop, try running the following command in your terminal to verify the installation:
    Copy

    npx -y @yiyang.1i/sms-mcp-server

Configuration

The server requires three environment variables:

• ACCOUNT_SID: Your Twilio account SID
• AUTH_TOKEN: Your Twilio auth token
• FROM_NUMBER: Your Twilio phone number (in E.164 format, e.g., +11234567890)

Claude Desktop Configuration

To use this server with Claude Desktop, add the following to your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@yiyang.1i/sms-mcp-server"
      ],
      "env": {
        "ACCOUNT_SID": "your_account_sid",
        "AUTH_TOKEN": "your_auth_token",
        "FROM_NUMBER": "your_twilio_number"
      }
    }
  }
}

After that, restart Claude Desktop to reload the configuration. If connected, you should see Twilio under the 🔨 menu.

Troubleshooting

Common error messages and solutions:

1. "Phone number must be in E.164 format"

   • Make sure the phone number starts with "+" and the country code

2. "Invalid credentials"

   • Double-check your ACCOUNT_SID and AUTH_TOKEN. You can copy them from the Twilio Console

License

This project is licensed under the MIT License - see the LICENSE file for details.