Twilio SMS Server

Provides an MCP server to send SMS via Twilio and a REST API for cloud apps.

typescript

0

GitHub Stars

typescript

Language

5 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": {
    "mustafa-boorenie-twilio_sms_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yiyang.1i/sms-mcp-server"
      ],
      "env": {
        "PORT": "3000",
        "AUTH_TOKEN": "YOUR_AUTH_TOKEN",
        "ACCOUNT_SID": "YOUR_ACCOUNT_SID",
        "FROM_NUMBER": "+1234567890"
      }
    }
  }
}

You deploy and run a Twilio SMS MCP server that works either as an MCP endpoint for Claude Desktop or as a standalone Web API in the cloud. It handles Twilio credentials securely and provides ready-made prompts for common messaging tasks, along with Docker and cloud deployment options.

How to use

Use this server to send SMS messages through Twilio from your Claude Desktop or any application that supports the MCP protocol. In MCP mode, you run the local server and connect Claude Desktop so your assistants can send messages. In Web API mode, you run a REST API in the cloud and integrate it with web applications.

How to install

Prerequisites you need before installing:

Node.js version 18 or newer
npm or npx available in your environment
A Twilio account with SMS capabilities and your credentials ready to use in environment variables

Install and run the server with these steps. Copy each command exactly as shown.

Install steps

# Install dependencies
npm install

# Build the project
npm run build

# Run as MCP server (for Claude Desktop)
npm run start:mcp

# Run as Web API server
npm run start:web

# Development mode (rebuilds and starts web server)
npm run dev:web

Configure environment for local development

# Twilio Configuration (Required)
ACCOUNT_SID=your_twilio_account_sid_here
AUTH_TOKEN=your_twilio_auth_token_here
FROM_NUMBER=+1234567890

# Server Configuration (Optional, defaults to 3000)
PORT=3000

Claude Desktop MCP setup example

To enable Claude Desktop to access the MCP server, add an MCP entry that points to the local MCP server configuration. This example shows how to configure the client to run an MCP server package and expose your Twilio credentials.

{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "-y",
        "@yiyang.1i/sms-mcp-server"
      ],
      "env": {
        "ACCOUNT_SID": "your_account_sid",
        "AUTH_TOKEN": "your_auth_token",
        "FROM_NUMBER": "your_twilio_number"
      }
    }
  }
}

Cloud deployment options

Choose a cloud deployment option to expose the Web API publicly. The following are common hosting platforms with their setup patterns.

Cloud deployment options details

Railway, Render, and Heroku provide straightforward paths to run the Web API. Use the published build and start commands, and set your Twilio credentials as environment variables.

Available tools

send-sms

Sends a text message to a specified recipient using Twilio.

send-greeting

Sends a greeting message for occasions like birthdays.

health

Health check endpoint to verify the server is running.