Skip to main content
Glama

Twilio Messaging MCP Server

by deshartman

Twilio Messaging MCP Server

An MCP server for sending SMS messages via Twilio API. This server provides tools, resources, and prompts for interacting with the Twilio Messaging API.

Features

  • Send SMS messages via Twilio
  • Get status callbacks from Twilio with enhanced handling via @deshartman/mcp-status-callback
  • Integrates with Claude AI via the Model Context Protocol (MCP)
  • Executable via npx for easy usage without installation

Prerequisites

  • Node.js >= 18.0.0
  • Twilio account with:
    • Account SID
    • API Key and Secret
    • Twilio phone number
  • ngrok account with:
    • Auth token
    • Custom domain (optional)

Installation

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

Or run directly with npx:

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

NPX Usage

The package can be executed directly using npx without installation:

# Run with required parameters npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number> # With environment variables for ngrok env NGROK_AUTH_TOKEN=your_token NGROK_CUSTOM_DOMAIN=your_domain.ngrok.dev npx @deshartman/twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

This is possible because the package includes the "bin" field in package.json, making it executable via npx.

Environment Variables

  • NGROK_AUTH_TOKEN: Your ngrok authentication token (required for callback handling)
  • NGROK_CUSTOM_DOMAIN: Your custom ngrok domain (optional)

Usage

Running the Server

You can run the server using the provided script with a .env file:

# Create a .env file with your credentials # See .env.example for the required format # Run the server (no arguments needed) ./run-server.sh

The .env file should contain:

ACCOUNT_SID=YOUR_ACCOUNT_SID API_KEY=YOUR_API_KEY API_SECRET=YOUR_API_SECRET TWILIO_NUMBER=YOUR_TWILIO_PHONE_NUMBER NGROK_AUTH_TOKEN=YOUR_NGROK_AUTH_TOKEN NGROK_CUSTOM_DOMAIN=your-domain.ngrok.dev

This approach improves security by keeping credentials out of command history and simplifies the execution process.

Directly with Node.js

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

MCP Integration

This server provides the following MCP capabilities:

Tools

  • send-sms: Send an SMS message via Twilio with server readiness validation

Resources

  • twilio://statuscallback: Get the last raw status callback data from Twilio with enhanced error handling

Prompts

  • SendSMS: Prompt for sending an SMS using Twilio Messaging MCP Server

Troubleshooting

ngrok Tunnel Issues

If you encounter an error like:

failed to start tunnel: The endpoint 'https://your-domain.ngrok.dev' is already online.

You have a few options:

  1. Stop your existing endpoint first
  2. Use a different domain name
  3. Start both endpoints with --pooling-enabled to load balance between them

ENOTEMPTY Error

If you encounter an npm error like:

npm ERR! code ENOTEMPTY npm ERR! syscall rename

Try running the server directly with Node.js instead of using npx.

License

MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP (Model Context Protocol) server that lets users send SMS messages through Twilio API directly from Claude Desktop via natural language commands.

  1. Features
    1. Installation
      1. Configuration
        1. Security Note
      2. Usage with Claude Desktop
        1. Local Development
        2. After Publishing to npm
      3. Available Tools
        1. send-sms
      4. Development
        1. Running the Server Manually
      5. License

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables Claude and other AI assistants to send SMS and MMS messages using Twilio.
          Last updated -
          47
          10
          MIT License
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that integrates high-quality text-to-speech capabilities with Claude Desktop and other MCP-compatible clients, supporting multiple voice options and audio formats.
          Last updated -
          10
          1
          MIT License
        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol (MCP) server that allows AI agents like Claude to interact with the Aligo SMS API to send text messages and retrieve related information.
          Last updated -
          1
          MIT License
        • -
          security
          A
          license
          -
          quality
          An implementation of the Model Context Protocol (MCP) server that exposes Twilio APIs to AI assistants and tools, allowing them to interact with Twilio services through the MCP protocol.
          Last updated -
          63
          MIT License

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/deshartman/twilio-messaging-mcp-server'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server