Twilio Messaging

Provides an MCP server to send Twilio SMS, handle status callbacks, and integrate with Claude AI via MCP.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "deshartman-twilio-messaging-mcp-server": {
      "command": "npx",
      "args": [
        "@deshartman/twilio-messaging-mcp-server",
        "<accountSid>",
        "<apiKey>",
        "<apiSecret>",
        "<number>"
      ],
      "env": {
        "NGROK_AUTH_TOKEN": "YOUR_NGROK_AUTH_TOKEN",
        "NGROK_CUSTOM_DOMAIN": "your-domain.ngrok.dev"
      }
    }
  }
}

This MCP Server lets you send SMS messages through the Twilio API, handles status callbacks with enhanced error handling, and integrates with the Model Context Protocol for Claude AI. It is executable directly with npx for quick usage without installation and supports secure operation with environment-based credentials.

How to use

You interact with this server through an MCP client to send SMS messages and manage status callbacks. Use the send-sms tool to dispatch messages via Twilio, and rely on the twilio://statuscallback resource to retrieve the latest raw status callback data with improved error handling. This server is designed to work seamlessly with MCP clients and the Claude AI Model Context Protocol for enhanced context-aware interactions.

Typical workflow with an MCP client:

How to install

Prerequisites you need before starting:

Node.js 18 or newer
A Twilio account with Account SID, API Key & Secret, and a Twilio phone number
An ngrok account with an auth token (and an optional custom domain)

Install the MCP server package and run it directly with npx for immediate use:

npm install @deshartman/twilio-messaging-mcp-server

Or run directly with npx:

npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

If you want to use environment variables for ngrok during callbacks:

env NGROK_AUTH_TOKEN=your_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

Direct Node.js run

Alternatively, you can run the server directly via Node.js when you prefer to start from a built index.

env NGROK_AUTH_TOKEN=your_ngrok_auth_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev node build/index.js <accountSid> <apiKey> <apiSecret> <number>

Available tools

send-sms

Send an SMS message via Twilio with server readiness validation

Built by

VeilStrat

AI signals for GTM teams