ReadySMS MCP Server

Send SMS messages from any AI assistant — Claude, ClickUp, Cursor, Windsurf, and more. One-click setup.

Setup (30 seconds)

Step 1: Get your API key

1. Create a free account at readysms.io

2. Go to Settings → API Keys → Create Key

3. Copy your key (starts with rsms_)

Step 2: Add to your AI tool

Copy-paste the config for your platform:

1. In ClickUp, go to Apps → MCP Servers → Add Custom MCP Server

2. Enter:

   • Name: ReadySMS

   • URL: https://api.readysms.io/mcp

   • Auth: OAuth 2.0

3. Click Connect — you'll be redirected to sign in to ReadySMS and authorize ClickUp

4. Done! Ask ClickUp's AI to send texts, manage campaigns, check delivery rates, etc.

If you prefer local mode, add as an MCP integration in ClickUp's AI settings:

{
  "mcpServers": {
    "readysms": {
      "command": "npx",
      "args": ["-y", "readysms-mcp"],
      "env": {
        "READYSMS_API_KEY": "rsms_your_key_here"
      }
    }
  }
}

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "readysms": {
      "command": "npx",
      "args": ["-y", "readysms-mcp"],
      "env": {
        "READYSMS_API_KEY": "rsms_your_key_here"
      }
    }
  }
}

claude mcp add readysms -- npx -y readysms-mcp

Then set the env var in your shell or .env:

export READYSMS_API_KEY=rsms_your_key_here

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "readysms": {
      "command": "npx",
      "args": ["-y", "readysms-mcp"],
      "env": {
        "READYSMS_API_KEY": "rsms_your_key_here"
      }
    }
  }
}

Add to ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "readysms": {
      "command": "npx",
      "args": ["-y", "readysms-mcp"],
      "env": {
        "READYSMS_API_KEY": "rsms_your_key_here"
      }
    }
  }
}

Step 3: Start talking

Just ask your AI assistant naturally:

"Send a text to +15551234567 saying their appointment is tomorrow at 3pm"

"Show me my unread conversations"

"Draft a campaign to remind customers about our summer sale"

"How many credits do I have left?"

"Run a deliverability audit on my phone numbers"

Related MCP server: Twilio SMS Server

What You Can Do

Messaging

Inbox

Contacts

Campaigns

Automation

Analytics & Billing

Setup

Built-in Workflows

These pre-built prompts guide your AI through multi-step tasks:

• send_campaign — Walk through creating a campaign: check balance → AI-draft message → choose audience → save as draft

• inbox_summary — Summarize unread conversations, flag urgent items, show balance

• deliverability_audit — Audit every phone number with red/yellow/green health status

Environment Variables

Reliability

• Automatic retries with exponential backoff on 429/502/503/504

• 30-second timeout on all API calls (no hanging)

• Structured errors — clear, actionable messages (not stack traces)

• Phone number normalization — accepts (555) 123-4567, 5551234567, +15551234567

• Input validation — catches bad inputs before hitting the API

• Startup validation — verifies API key format immediately

Get Started

Don't have a ReadySMS account? Sign up free at readysms.io — takes under 2 minutes.

Need help? Email support@readysms.io