Enables sending SMS messages via the Twilio API using a configured Twilio phone number and account credentials.
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
Or run directly with npx:
NPX Usage
The package can be executed directly using npx without installation:
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:
The .env
file should contain:
This approach improves security by keeping credentials out of command history and simplifies the execution process.
Directly with Node.js
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:
You have a few options:
- Stop your existing endpoint first
- Use a different domain name
- Start both endpoints with
--pooling-enabled
to load balance between them
ENOTEMPTY Error
If you encounter an npm error like:
Try running the server directly with Node.js instead of using npx.
License
MIT
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
An MCP (Model Context Protocol) server that lets users send SMS messages through Twilio API directly from Claude Desktop via natural language commands.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables Claude and other AI assistants to send SMS and MMS messages using Twilio.Last updated -4710MIT License
- -securityAlicense-qualityA Model Context Protocol server that integrates high-quality text-to-speech capabilities with Claude Desktop and other MCP-compatible clients, supporting multiple voice options and audio formats.Last updated -101MIT License
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that allows AI agents like Claude to interact with the Aligo SMS API to send text messages and retrieve related information.Last updated -1MIT License
- -securityAlicense-qualityAn implementation of the Model Context Protocol (MCP) server that exposes Twilio APIs to AI assistants and tools, allowing them to interact with Twilio services through the MCP protocol.Last updated -63MIT License