home / mcp / twilio mcp server

Twilio MCP Server

Sends SMS via Twilio using a minimal, pure TypeScript MCP server.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "brennerspear-twilio-mcp": {
      "command": "npx",
      "args": [
        "tsx",
        "/path/to/twilio-mcp/src/index.ts",
        "--account-sid",
        "YOUR_ACCOUNT_SID",
        "--auth-token",
        "YOUR_AUTH_TOKEN",
        "--messaging-service-sid",
        "YOUR_MESSAGING_SERVICE_SID",
        "--default-to",
        "+1987654321"
      ]
    }
  }
}

This MCP server lets you send SMS messages through Twilio using a minimal, pure TypeScript setup with no build steps. It focuses on reliable tool schemas and straightforward usage so you can integrate SMS sending into your MCP workflow quickly.

How to use

You will connect to the Twilio MCP server as an MCP endpoint and invoke the available tool to send messages. The server runs via a simple command and accepts your Twilio credentials and a default recipient if you choose to provide one. The provided tool, send_text, sends a single SMS message to a specified number or to a configured default.

To send an SMS, call the send_text tool with the following fields: to (optional if you have a default recipient) and message (the text you want to send). The server requires your Twilio credentials and a messaging service SID to authorize sending messages.

How to install

Prerequisites: Node.js and npm or a compatible runtime environment. Ensure you have network access to reach Twilio APIs and that you can run external commands from your environment.

Install and start the MCP server by running the provided command. This uses npx to run the TypeScript entry point directly without a build step.

npx tsx src/index.ts --account-sid <sid> --auth-token <token> --messaging-service-sid <sid> [--default-to <number>]

Claude Code Configuration

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "tsx",
        "/path/to/twilio-mcp/src/index.ts",
        "--account-sid", "YOUR_ACCOUNT_SID",
        "--auth-token", "YOUR_AUTH_TOKEN",
        "--messaging-service-sid", "YOUR_MESSAGING_SERVICE_SID",
        "--default-to", "+1987654321"
      ]
    }
  }
}

Available tools

send_text

Send an SMS message. Required: message. Optional: to (recipient). If to is not provided, the default recipient configured with --default-to is used.