Setup
Install Twilio in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/twilio-labs/mcp
Follow the installation instructions in the repository README, then restart your MCP client.
- **Send SMS and WhatsApp messages**— Ask your assistant to compose and send messages via Twilio's messaging APIs.
- **Make and manage phone calls**— Initiate outbound calls, track call status, or modify live calls through the Twilio Voice API.
- **Look up phone numbers**— Retrieve carrier and caller name information for any phone number using Twilio Lookup.
- **Buy and configure phone numbers**— Search for available numbers and provision them in your account via the phone number APIs.
- **Filter exposed APIs by service**— Use the`--services`and`--tags`flags to limit which Twilio APIs are available to the assistant, reducing context size.
This is a monorepo for the Model Context Protocol server that exposes all of Twilio APIs.
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.
This monorepo contains two main packages:
- [mcp- MCP Server for all of Twilio's Public API
- ](https://github.com/twilio-labs/mcp/blob/HEAD/packages/mcp)[openapi-mcp-server- An MCP server that serves the given OpenAPI spec
Each package has its own comprehensive README with detailed documentation:
- ](https://github.com/twilio-labs/mcp/blob/HEAD/packages/openapi-mcp-server)[MCP Package Documentation
- ](https://github.com/twilio-labs/mcp/blob/HEAD/packages/mcp/README.md)[OpenAPI MCP Server Documentation
The easiest way to get started is by using npx:
```
`{ "mcpServers": { "twilio": { "command": "npx", "args": ](https://github.com/twilio-labs/mcp/blob/HEAD/packages/openapi-mcp-server/README.md)[ "-y", "@twilio-alpha/mcp", "YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET" ] } } }`
```
Visit[Twilio API Keys docsfor information on how to find/create your API Key and Secret.
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.
Both packages accept configuration parameters. Here's a brief overview:
- **MCP Server**: Use`--services`and`--tags`to filter which APIs to expose
- **OpenAPI MCP Server**: Use`--apiPath`to specify OpenAPI spec files location
For complete configuration details, refer to the package-specific documentation linked above.
```
`# Run tests npm test # Run linting npm run lint # Fix linting issues npm run lint:fix`
```
- **Context Size Limitations**: Due to LLM context limits, load specific APIs using`--services`or`--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.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the ISC License - see the LICENSE file for details.
Twilio runs an official remote MCP server — connect over a hosted URL instead of installing this one locally.
Manage your WhatsApp, SMS and Phone Calls using a single MCP connector
Connect to any function, any language, across network boundaries using AgentRPC.
Access your meeting transcripts, summaries, and action items from any AI assistant.
Connect Claude, ChatGPT, and other AI tools to your Granola meeting notes via MCP. Query your notes, search transcripts, and get meeting insights in your favorite AI assistants.
Build with the Kudosity API to send SMS and MMS. Access developer docs, API references and live testing tools to send messages, manage contact lists, configure webhooks and more.
Send SMS, WhatsApp, and RCS messages programmatically with DLT compliance. Manage contacts, schedule campaigns, and track delivery reports.
The VoIPstudio MCP server gives compatible AI assistants secure access to authorised VoIPstudio account data, including recordings, call detail records, live calls and voicemails in order to query call activity, analyse patterns, identify agent performance issues and generate QA or operations reports in plain English.
A bridge server connecting Agent Communication Protocol (ACP) agents with Model Context Protocol (MCP) clients.
This MCP server exposes ActivitySmith notifications and live activity tools.](https://www.twilio.com/docs/iam/api-keys)