deshartman/twilio-messaging-mcp-server
If you are the rightful owner of twilio-messaging-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
An MCP server for sending SMS messages via Twilio API, providing tools, resources, and prompts for interaction.
Twilio Messaging MCP Server
An MCP server for sending SMS messages via Twilio API. This server provides tools, resources, and prompts for interacting with the Twilio Messaging API.
Features
- Send SMS messages via Twilio
- Get status callbacks from Twilio with enhanced handling via
@deshartman/mcp-status-callback - Integrates with Claude AI via the Model Context Protocol (MCP)
- Executable via npx for easy usage without installation
Prerequisites
- Node.js >= 18.0.0
- Twilio account with:
- Account SID
- API Key and Secret
- Twilio phone number
- ngrok account with:
- Auth token
- Custom domain (optional)
Installation
npm install @deshartman/twilio-messaging-mcp-server
Or run directly with npx:
npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>
NPX Usage
The package can be executed directly using npx without installation:
# Run with required parameters
npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>
# With environment variables for ngrok
env NGROK_AUTH_TOKEN=your_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>
This is possible because the package includes the "bin" field in package.json, making it executable via npx.
Environment Variables
NGROK_AUTH_TOKEN: Your ngrok authentication token (required for callback handling)NGROK_CUSTOM_DOMAIN: Your custom ngrok domain (optional)
Usage
Running the Server
You can run the server using the provided script with a .env file:
# Create a .env file with your credentials
# See .env.example for the required format
# Run the server (no arguments needed)
./run-server.sh
The .env file should contain:
ACCOUNT_SID=YOUR_ACCOUNT_SID
API_KEY=YOUR_API_KEY
API_SECRET=YOUR_API_SECRET
TWILIO_NUMBER=YOUR_TWILIO_PHONE_NUMBER
NGROK_AUTH_TOKEN=YOUR_NGROK_AUTH_TOKEN
NGROK_CUSTOM_DOMAIN=your-domain.ngrok.dev
This approach improves security by keeping credentials out of command history and simplifies the execution process.
Directly with Node.js
env NGROK_AUTH_TOKEN=your_ngrok_auth_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev node build/index.js <accountSid> <apiKey> <apiSecret> <number>
MCP Integration
This server provides the following MCP capabilities:
Tools
send-sms: Send an SMS message via Twilio with server readiness validation
Resources
twilio://statuscallback: Get the last raw status callback data from Twilio with enhanced error handling
Prompts
SendSMS: Prompt for sending an SMS using Twilio Messaging MCP Server
Troubleshooting
ngrok Tunnel Issues
If you encounter an error like:
failed to start tunnel: The endpoint 'https://your-domain.ngrok.dev' is already online.
You have a few options:
- Stop your existing endpoint first
- Use a different domain name
- Start both endpoints with
--pooling-enabledto load balance between them
ENOTEMPTY Error
If you encounter an npm error like:
npm ERR! code ENOTEMPTY
npm ERR! syscall rename
Try running the server directly with Node.js instead of using npx.
License
MIT
