README.md•2.89 kB
# 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 🔒
## Requirements
- Node.js >= 18
- If you need to update Node.js, we recommend using `nvm` (Node Version Manager):
```bash
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:
```bash
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`
```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.
## 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
## 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](https://console.twilio.com)
## Contributing
Contributions are welcome! Please read our contributing guidelines before submitting pull requests.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Security
Please do not include any sensitive information (like phone numbers or Twilio credentials) in GitHub issues or pull requests.