Twilio Messaging Interface Service (MCP Endpoint)

This service operates as a Model Context Protocol (MCP) server, enabling large language models like Claude to transmit short message service (SMS) and multimedia messaging service (MMS) payloads utilizing the Twilio API infrastructure.

Demonstration

[Placeholder for demo content/link]

Key Capabilities

• Facilitates outbound SMS transmission 📱
• Provides curated, ready-to-use templates for typical messaging requirements 📝
• Implements rigorous security protocols for protecting Twilio authentication secrets 🔒

Prerequisites

Requires Node.js version 18 or newer.

To ensure compatibility with the required runtime, consider utilizing the Node Version Manager (nvm): bash nvm install 18.14.2 nvm alias default 18.14.2

For validation purposes within the Claude Desktop environment, execute this verification command in your shell: bash npx -y @yiyang.1i/sms-mcp-server

Operational Setup

The service mandates the definition of three critical environment variables:

• ACCOUNT_SID: The unique identifier for your Twilio account.
• AUTH_TOKEN: Your confidential token for authenticating API requests.
• FROM_NUMBER: The originating Twilio telephone number, strictly adhering to E.164 numerical notation (e.g., +11234567890).

Configuration for Claude Desktop Integration

Incorporate the subsequent JSON configuration block into your Claude Desktop settings file:

macOS Path: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows Path: %APPDATA%\Claude\claude_desktop_config.json

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

Apply these changes by relaunching the Claude Desktop application. A successful connection will manifest as 'Twilio' being visible under the application's tools menu (🔨).

Illustrative Usage Examples via Claude

These demonstrate natural language requests mapped to the server's functionality:

1. Standard Text Dispatch:

Relay a text message to +11234567890 containing the notification: "Reminder: Dinner engagement is scheduled for this evening!"

1. Content Generation and Delivery:

Compose a three-line poem capturing the essence of autumn and dispatch it via SMS to my mobile number, +11234567890.

Critical Directives

1. Number Formatting Mandate: All recipient and sender numbers MUST conform to the E.164 standard (commencing with a '+' followed by the country code).
2. Service Constraints: Users must monitor and respect the messaging throughput limitations and associated costs tied to their Twilio subscription.
3. Credential Security Protocol: Uphold the confidentiality of your Twilio credentials; prohibit their inclusion in any committed source code repositories.

Issue Resolution Guide

Troubleshooting common API rejections:

1. Error: "Phone number must be in E.164 format"

2. Action: Verify that the telephone identifier begins with the '+' sign and includes the proper international dialing code.

3. Error: "Invalid credentials"

4. Action: Systematically re-enter and verify the ACCOUNT_SID and AUTH_TOKEN values, referencing the Twilio Console for validation.

Community Contributions

We welcome external submissions. Kindly review the contribution guidelines prior to submitting any pull requests.

Licensing Information

This utility is distributed under the terms of the MIT License (refer to the LICENSE file for comprehensive details).

Security Notice

Refrain from posting any private data, such as Twilio secrets or personal phone numbers, within public forums like GitHub issues or pull request descriptions.