# twilio-mcp

Simple MCP server for sending SMS via Twilio. Pure TypeScript, no build step.

> **Why this exists:** The [official Twilio MCP](https://github.com/twilio-labs/mcp) has a [bug](https://github.com/twilio-labs/mcp/issues/42) that causes invalid tool schemas, making it unusable with Claude. This is a minimal alternative that just works.

## Usage

```
npx tsx src/index.ts --account-sid <sid> --auth-token <token> --messaging-service-sid <sid> [--default-to <number>]
```

### Arguments

- `--account-sid` - Twilio Account SID (required)
- `--auth-token` - Twilio Auth Token (required)
- `--messaging-service-sid` - Twilio Messaging Service SID (required)
- `--default-to` - Default recipient phone number (optional)

## Claude Code Configuration

Add to `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "twilio": {
      "command": "npx",
      "args": [
        "tsx",
        "/path/to/twilio-mcp/src/index.ts",
        "--account-sid", "YOUR_ACCOUNT_SID",
        "--auth-token", "YOUR_AUTH_TOKEN",
        "--messaging-service-sid", "YOUR_MESSAGING_SERVICE_SID",
        "--default-to", "+1987654321"
      ]
    }
  }
}
```

## Tools

### send_text

Send an SMS message.

**Parameters:**
- `to` (optional if `--default-to` is set) - Recipient phone number in E.164 format
- `message` (required) - The text message to send