Twilio

This MCP server lets Claude and other AI assistants send SMS and MMS via Twilio by exposing a simple, configurable MCP endpoint you can connect to from your client applications. It handles Twilio credentials securely and provides ready-to-use prompts for common messaging scenarios so you can send messages quickly and safely.

How to use

Connect your MCP client to the Twilio MCP Server to send SMS or MMS messages. You will typically run the MCP server locally or on a host, then configure your client to point to the server using the provided stdio MCP command. Once connected, you can issue natural language prompts like sending a text to a specific number or composing a message and sending it to a recipient.

How to install

Prerequisites you need before installing:
- Node.js version 18 or later
- npm or npx to run MCP commands

Install the required Node.js version using a Node Version Manager (recommended):
```bash
nvm install 18.14.2
nvm alias default 18.14.2

Verify the MCP server command works by running a quick check:

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

If you are setting up Claude Desktop, you will configure the MCP server in your Claude desktop configuration to load the server automatically on startup.

## Additional configuration and usage details

Environment variables required by the server:
- ACCOUNT\_SID: Your Twilio account SID
- AUTH\_TOKEN: Your Twilio auth token
- FROM\_NUMBER: Your Twilio phone number in E.164 format (for example, +11234567890)

## Configuration

Use the following MCP configuration to run the server through a local stdio channel via npx. This config will load the MCP server and expose the standard prompt endpoints to your client.

{ "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" } } } }

## Example interactions with Claude

Simple SMS: "Send a text message to the number +11234567890 saying \"Don’t forget about dinner tonight!\""

Creative SMS: "Write a haiku about autumn and send it to my number +11234567890"

## Important notes

- Phone numbers must be in E.164 format (e.g., +11234567890)
- Be mindful of Twilio rate limits and pricing
- Keep Twilio credentials secure and never commit them to version control
## Troubleshooting

Common issues you might see and how to resolve them:
- Phone number must be in E.164 format: Ensure the number starts with "+" and includes the country code.
- Invalid credentials: Double-check ACCOUNT\_SID and AUTH\_TOKEN and re-enter them from the Twilio Console.

## Security

Keep Twilio credentials secure. Do not expose ACCOUNT\_SID, AUTH\_TOKEN, or FROM\_NUMBER in public places or version-controlled files.

## Contributing

Contributions are welcome. Follow standard contribution guidelines when submitting changes.

## License

This project is licensed under the MIT License.

## Tools and capabilities

The server supports sending SMS messages and provides prompts for common messaging scenarios, including simple and creative text generation.