Deshartman Twilio Messaging MCP Server

🚀 Twilio Messaging Service MCP Server

An MCP (Model Context Protocol) server that uses the Twilio API to send SMS messages.

🚀 Quick Start

The Twilio Messaging Service MCP Server is designed to send SMS messages using the Twilio API. It can be easily integrated with MCP clients like Claude Desktop.

✨ Features

• Send SMS messages via the Twilio API.
• Integrate with MCP clients such as Claude Desktop.
• Securely handle credentials without using environment variables.
• Enhance security by using Twilio API Keys.

📦 Installation

You can run the server directly using npx:

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

Or install it globally:

npm install -g twilio-messaging-mcp-server
twilio-messaging-mcp-server <accountSid> <apiKey> <apiSecret> <number>

📚 Documentation

Configuration

The server requires the following parameters:

⚠️ Important Note

This server uses API Keys and Secrets instead of Auth Tokens to enhance security. This approach provides better access control and allows you to revoke credentials when needed. For more details, please refer to the Twilio API Keys documentation.

Usage with Claude Desktop

Local Development

For local development (when the package is not published to npm), add the following to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "node",
      "args": [
        "/PATHTONODE/twilio-messaging-mcp-server/build/index.js",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

Replace the values with your actual Twilio credentials:

• The first parameter: Your Twilio account SID (starts with "AC").
• The second parameter: Your Twilio API Key (starts with "SK").
• The third parameter: Your Twilio API Secret.
• The fourth parameter: Your Twilio phone number in E.164 format.

You can get the absolute path using the following commands:

# On macOS/Linux
echo "$(pwd)/build/index.js"

# On Windows (PowerShell)
Write-Output "$((Get-Location).Path)\build\index.js"

After Publishing to npm

Once the package is published to npm, you can use the following configuration:

{
  "mcpServers": {
    "twilio-messaging": {
      "command": "node",
      "args": [
        "twilio-messaging-mcp-server/build/index.js",
        "your_account_sid_here",
        "your_api_key_here",
        "your_api_secret_here",
        "+1234567890"
      ]
    }
  }
}

💻 Usage Examples

Available Tools

• send-sms: A tool to send SMS messages via the Twilio API.
  • Parameters:
    • --accountSid: Your Twilio account SID.
    • --apiKey: Your Twilio API Key.
    • --apiSecret: Your Twilio API Secret.
    • --to: The phone number to receive the message.
    • --message: The message to be sent.

Development Instructions

Install Dependencies

npm install

Run the Test Server

node build/index.js <accountSid> <apiKey> <apiSecret> <number>

Example

node build/index.js AC123456789 SK0123456789 abcdefghijklmn +1234567890

📄 License

[Add license information here]