sms

This MCP server exposes Twilio SMS/MMS sending capabilities to Claude and other AI assistants via the MCP protocol. When configured, you can send texts or multimedia messages by issuing natural language prompts such as “Send a text message to +15551234567 saying 'Hello there'” or more creative prompts that leverage predefined templates. The server manages Twilio credentials securely through environment variables, so you never need to expose your credentials in prompts. In Claude Desktop, once configured, the Twilio MCP server appears under the MCP integration menu and can be used to compose and dispatch messages directly from conversations with AI assistants.

Prerequisites:

• Node.js >= 18 installed on the host (preferably via nvm)
• Access to a Twilio account with ACCOUNT_SID, AUTH_TOKEN, and a valid FROM_NUMBER in E.164 format

Installation steps:

1. Install Node.js 18.x (example via nvm): nvm install 18.14.2 nvm alias default 18.14.2

2. Verify the MCP server can be retrieved via npx (no global install required): npx -y @yiyang.1i/sms-mcp-server

3. Run the MCP server using the recommended npx command: npx -y @yiyang.1i/sms-mcp-server

4. Optional: If integrating with Claude Desktop, add the following configuration to Claude’s MCP settings (adjust the path to the config file as needed): { "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" } } } }

Environment variables ACCOUNT_SID, AUTH_TOKEN, and FROM_NUMBER must be kept secure. Use a secrets manager or Claude's secure storage if available. Ensure the FROM_NUMBER is in E.164 format (e.g., +12345678900). Be mindful of Twilio rate limits and pricing. If you see errors about credential validity, re-check the Twilio Console for the correct Account SID and Auth Token. For troubleshooting, verify that the FROM_NUMBER is a verified Twilio number capable of sending messages in your account’s region and that your Twilio account has sufficient credit.