Yiyangli Sms MCP Server

🚀 Twilio MCP Server

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

🎥 Demo

✨ Features

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

📦 Installation

Configuration Requirements

Three environment variables are required:

• ACCOUNT_SID: Your Twilio account SID
• AUTH_TOKEN: Your Twilio authentication 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 configuration, restart Claude Desktop to reload the settings. If the connection is successful, you should see Twilio under the ⚙️ menu.

💻 Usage Examples

Basic Usage

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

1. Simple SMS:

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

2. Creative SMS:

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

⚠️ Important Note

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

🔧 Troubleshooting

Common error messages and solutions:

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

   • Ensure the phone number starts with a "+" and includes the country code.

2. "Invalid credentials"

   • Check your ACCOUNT_SID and AUTH_TOKEN. You can copy them from the Twilio console.

🤝 Contribution

Contributions are welcome! Please read our contribution guidelines before submitting a pull request.

📄 License

This project is released under the MIT License. See the LICENSE file for details.

🔒 Security

Do not include any sensitive information (such as phone numbers or Twilio credentials) in GitHub issues or pull requests.