MCP Directory

How to add Twilio MCP Server (Twilio Alpha) to Windsurf

Official Twilio MCP exposing Twilio's public API — SMS, voice, messaging and more Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 105★ · stdio · apikey · official

Windsurf config for Twilio MCP Server (Twilio Alpha)

npx -y @twilio-alpha/mcp <ACCOUNT_SID>/<API_KEY>:<API_SECRET>
{
  "mcpServers": {
    "twilio-mcp-server-twilio-alpha": {
      "command": "npx",
      "args": [
        "-y",
        "@twilio-alpha/mcp",
        "<ACCOUNT_SID>/<API_KEY>:<API_SECRET>"
      ]
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Twilio MCP Server (Twilio Alpha) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Twilio MCP Server (Twilio Alpha)'s tools become available to Cascade.

Before you start

  • Node.js 18+ and npm 9+ (run via npx, no global install needed)
  • An active Twilio account
  • A Twilio Account SID (starts with AC…) from the Twilio Console
  • A Twilio API Key SID and Secret created in Console under Account > API keys & tokens (IAM)

What Twilio MCP Server (Twilio Alpha) can do in Windsurf

Messaging / SMS APIs

Send and manage SMS/MMS and messaging services (e.g. twilio_messaging_v1, Api20100401Message)

Voice APIs

Create and manage calls and voice resources via the Voice/Api endpoints

Conversations APIs

Manage conversations, participants and messages (twilio_conversations_v1)

Studio APIs

Trigger and manage Studio flow executions (StudioV2Flow)

TaskRouter APIs

Manage workspaces, workers, tasks and queues

Serverless APIs

Manage Functions/Assets services and deployments (twilio_serverless_v1)

Phone Number APIs

List and manage incoming phone numbers (Api20100401IncomingPhoneNumber)

Verify APIs

Start and check Verify OTP verifications and services

Security

Uses a Twilio API key/secret that can send billable SMS/voice and modify account resources, so use a restricted API key and scope the server to specific services. Credentials are passed as a CLI argument and may appear in process listings — prefer running in an isolated environment.

Twilio MCP Server (Twilio Alpha) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Twilio MCP Server (Twilio Alpha) config there under the "mcpServers" key and restart the client.

Is Twilio MCP Server (Twilio Alpha) safe to use with Windsurf?

Uses a Twilio API key/secret that can send billable SMS/voice and modify account resources, so use a restricted API key and scope the server to specific services. Credentials are passed as a CLI argument and may appear in process listings — prefer running in an isolated environment.

How do I authenticate?

Pass your credentials as ACCOUNT_SID/API_KEY:API_SECRET on the command line. Create the API Key and Secret in the Twilio Console under Account > API keys & tokens; the Account SID is on your Console dashboard.

Why do I have to use --services and --tags?

Twilio's full API is too large to expose as tools at once and would exhaust the model's context. The flags let you load only the service groups and endpoint tags you actually need.

Is this maintained by Twilio?

Yes, it is published by Twilio Alpha (twilio-labs) under the @twilio-alpha/mcp package and MIT license. Twilio describes it as an alpha / proof of concept.

View repo Full Twilio MCP Server (Twilio Alpha) page