PlugWiki
Twilio MCP Server logo

Twilio MCP Server, Twilio Alpha's server for the Twilio API

Official · by TwilioLocal
Getnpm@twilio-alpha/mcptwilio-labs/mcpDocs
Stars
113
on GitHub
Works in
1
supported apps
Risk
High
can delete
Auth
API key
Version
0.7.0
last commit Feb 2026

Lets your AI assistant send texts, make calls and manage your Twilio account through Twilio's own APIs.

This is the server Twilio's Emerging Tech team built to turn Twilio's public APIs into tools your assistant can use. You pick which parts of Twilio to load, such as messaging, phone numbers or Serverless, because the full set is far too big for one chat. It runs on your computer with a Twilio API key, and Twilio still calls it an alpha proof of concept. Before you rely on it in Claude, know that some message and call history tools currently break Claude sessions with an error.

Good for

  • Developers building on Twilio who want Claude or Cursor to call the API while they code
  • Teams that send SMS or WhatsApp messages and want to do quick sends or lookups from chat
  • Twilio admins checking numbers, Studio flows or Serverless deployments without the console

Works in

1 supported · 2 with issues · 9 should work

Tap an app to see how to set it up and any known problems.

Install Twilio MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Twilio MCP server to Claude Code. Run this command:

claude mcp add twilio -- npx -y @twilio-alpha/mcp YOUR_ACCOUNT_SID/YOUR_API_KEY:YOUR_API_SECRET

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 20+, Twilio API key and secret.

Replace the last argument with your Account SID, an API key and its secret, joined as shown. Create the key in the Twilio console under API keys.

Twilio's API is too large to load whole. Add --services twilio_serverless_v1 (or another service name from the README) after the credentials, or --tags with endpoint tags such as Api20100401IncomingPhoneNumber,StudioV2Flow. In a JSON or TOML config, each flag and its value go in args as separate entries.

In Claude, loading the core API (twilio_api_v2010) can make every request fail with a "Property keys should match pattern" error, because some of its list tools have names Claude rejects. Pick narrower services or tags until the fix ships.

Built from the package data we hold. Not yet tested by us.

Tools

We don't list Twilio MCP's tools here yet. After you connect it, ask your assistant "What can you do with Twilio MCP?" to see them.

Pros and cons

Good

  • Built by Twilio's own Emerging Tech team.
  • Reaches nearly all of Twilio's public API, from messaging and voice to Studio and Serverless.
  • You choose which services or endpoints to load, so it fits in the assistant's context.
  • Free and MIT licensed; you pay only for the Twilio usage it triggers.
  • Uses a standard Twilio API key that you can revoke at any time.

Watch out

  • Some core API list tools break Claude sessions with an error that has been open for months.
  • No read-only mode.
  • Runs only on your computer; there is no hosted version for API actions.
  • Credentials go on the command line instead of in environment variables.
  • Images in WhatsApp and MMS messages fail to send.
  • Labelled alpha, with the last release in July 2025.

Permissions

high risk · 5 things to watch

High risk

The assistant can send messages, place calls and delete account resources with your key, and every action costs or changes something real. Load only the services you need, use a separate API key, and approve each tool call.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can send messages, place calls and spend money

    With the right services loaded it can send texts, start calls, buy or release numbers and delete resources. Load only the services you need. github.com

  • Tools are not marked as safe or risky

    No tool says whether it only reads or changes things, so your client cannot warn you before a send or delete. Keep tool approval on. github.com

  • Your API secret sits on the command line

    The key and secret are passed as a command argument, which other programs can see. Create a separate API key for this and revoke it when you stop. github.com

  • Twilio says not to run it with community servers

    Twilio's team advises against running community MCP servers alongside it, to stop injected instructions reaching your account. github.com

  • An alpha project with slow fixes

    Twilio calls it a proof of concept, the last release was July 2025, and fixes for open bugs wait unmerged. registry.npmjs.org

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks toTwilio API
Sign-in and keysAccount SID, API key and secret passed as a command argument in your client's config file.

Alternatives

Use Twilio's server when you need more than texting, such as numbers, Studio or Serverless, and can live with its Claude bug. For just sending SMS or WhatsApp, a smaller community server is simpler, and the logs server is the only read-only choice.

ServerOfficialRunsCan change thingsGitHub starsWeekly downloads
Twilio MCP ServerThis pageOfficialLocalYes113–
CodeSpar TwilioCommunityLocalYes–39/wk
twilio-mcp-serverCommunityLocalYes–382/wk
Pipeworx TwilioCommunityHostedLocalYes014/wk
Twilio logs serverCommunityLocalNo05/wk

What people say

People like how much of Twilio it reaches and are frustrated that a long-open bug breaks it in Claude.

What people like

  • Sending WhatsApp messages from Claude Desktop works well for at least one tester.
  • It covers far more of Twilio than any community server, from messaging to Serverless.

Common complaints

  • Many Claude Code and Claude Desktop users report sessions breaking with schema errors, still unfixed.
  • One user gave up and rebuilt it in another framework.
  • Images in WhatsApp and MMS messages fail because media links are sent in the wrong format.
  • Some tools, such as creating Content templates, have no parameters and cannot be used.
  • Credentials go on the command line, where they show up in process lists.

In their words

GitHub issueJan 2026
“the current mcp provided is unusable.”
rsp2kGitHub issueJun 2025
“I've been testing sending WhatsApp messages through Claude desktop, and it works great, but I noticed the MediaUrl parameter doesn't work, so I can't send images.”
rodrigotavio91GitHub issueMay 2026
“Failure is session-wide — every `/clear` breaks until you patch `<`/`>` → `_lt`/`_gt` manually in the npx cache.”
Bulldogz9495GitHub issueOct 2025
“Tried to isolate the issue and this is solved only when I'm not using the twilio MCP”
stavarc

Questions

Is the Twilio MCP server free?

Yes, the server is free and open source. Twilio still bills your account for the messages, calls and numbers it uses, at your normal rates.

Why does Claude say "Property keys should match pattern"?

Some of the core API's list tools for calls, messages and recordings have parameter names Claude rejects. Once one loads, every request in that chat fails. A fix is waiting to be merged, so for now load only the services and tags you need and leave those list tools out.

Is there a hosted Twilio MCP server URL?

Only for documentation. https://mcp.twilio.com/docs lets an assistant search Twilio's docs with no account, but it cannot send messages or call the API. This server, which does call the API, runs on your own computer.

What credentials do I need?

Your Account SID and an API key with its secret, created in the Twilio console. Make a separate key for your assistant so you can revoke it on its own.

How do I stop it from loading every Twilio API?

Choose services or endpoint tags when you add it, as shown in the install box. Twilio's API is too big to load whole, so pick only what you use, such as messaging or phone numbers.

Can it send SMS and WhatsApp messages?

Yes, if you load the messaging part of the core API. One user reports that attaching images fails because the media link is sent in the wrong format.

Is it safe to use?

Only with care. It can send messages, place calls and delete resources that cost money, and it has no read-only mode. Keep tool approval on and do not run community MCP servers next to it, as Twilio advises.

Is it still maintained?

Slowly. Twilio labels it alpha, the last release came out in July 2025, and fixes for the open Claude bug are still waiting.

How do I add it to Claude Desktop or Cursor?

Use the steps in the install box above. You will need your Account SID, API key and secret ready.

Examples

  • Send WhatsApp messages from Claude Desktop

    Source

  • Manage incoming phone numbers and Studio flows with only those endpoints loaded

    List my Twilio phone numbers and show which Studio flow each one points to.

  • Work with Twilio Serverless functions and deployments

    Show the latest deployment for my Serverless service and list its functions.

  • Check your account balance from chat

    Source

Information

updated Nov 2, 2026

Publisher
Twilio (official)
Package
@twilio-alpha/mcp
Registry
npm
Transport
stdio
Auth
API key
Version
0.7.0
License
MIT
Last commit
Feb 14, 2026
Open issues
13

DocsGitHubnpmChangelogIssues

Other Twilio MCP servers

See all

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 13
  1. github.com · github.com
  2. Use the Twilio Alpha MCP Server to Automate Development · twilio.com
  3. github.com · github.com
  4. github.com · github.com
  5. github.com · github.com
  6. github.com · github.com
  7. registry.npmjs.org · registry.npmjs.org
  8. github.com · github.com
  9. www.twilio.com · twilio.com
  10. API Error When using the MCP · github.com
  11. Tool input_schema property keys contain invalid characters, breaking Claude Code subagents · github.com
  12. github.com · github.com
  13. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.