Summary
This is Twilio's official MCP server that exposes their entire public API surface to Claude through auto-generated tools from OpenAPI specs. You get access to everything from sending SMS and making calls to managing phone numbers, conversations, and serverless functions. The monorepo also includes the underlying OpenAPI to MCP converter, which you can point at any OpenAPI spec. Reach for this when you want Claude to interact with your Twilio account directly, whether that's automating customer communications, managing telephony infrastructure, or building conversational workflows. The team recommends running it in isolation from community servers to avoid injection attacks that could expose your account credentials.
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Twilio MCP Monorepo
This is a monorepo for the Model Context Protocol server that exposes all of Twilio APIs.
What is MCP?
The Model Context Protocol (MCP) is a protocol for exchanging model context information between AI tools and services. This implementation allows you to expose Twilio's APIs to AI assistants and other tools that support the MCP protocol.
Packages
This monorepo contains two main packages:
- mcp - MCP Server for all of Twilio's Public API
- openapi-mcp-server - An MCP server that serves the given OpenAPI spec
Each package has its own comprehensive README with detailed documentation:
Quick Start
The easiest way to get started is by using npx:
{
"mcpServers": {
"twilio": {
"command": "npx",
"args": [
"-y",
"@twilio-alpha/mcp",
"YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET"
]
}
}
}
Visit Twilio API Keys docs for information on how to find/create your API Key and Secret.
Security Recommendations
To guard against injection attacks that may allow untrusted systems access to your Twilio data, the ETI team advises users of Twilio MCP servers to avoid installing or running any community MCP servers alongside our official ones. Doing so helps ensure that only trusted MCP servers have access to tools interacting with your Twilio account, reducing the risk of unauthorized data access.
Basic Configuration Options
Both packages accept configuration parameters. Here's a brief overview:
- MCP Server: Use
--servicesand--tagsto filter which APIs to expose - OpenAPI MCP Server: Use
--apiPathto specify OpenAPI spec files location
For complete configuration details, refer to the package-specific documentation linked above.
Development
# Run tests
npm test
# Run linting
npm run lint
# Fix linting issues
npm run lint:fix
Troubleshooting Common Issues
- Context Size Limitations: Due to LLM context limits, load specific APIs using
--servicesor--tags - Authentication Issues: Verify your Twilio API credentials format and permissions
- API Versioning: Check you're using the correct API version (v1, v2, v3) for your needs
For detailed troubleshooting guidance, see the package-specific documentation.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the ISC License - see the LICENSE file for details.
Featured
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
