call-me-cloud-mcp

MCP (Model Context Protocol) client that enables Claude to make phone calls and send WhatsApp messages via Call-Me Cloud.

What is this?

This package lets Claude Code call you on the phone or message you on WhatsApp. It connects to a Call-Me Cloud server (which you deploy) and provides MCP tools for initiating and managing voice calls and text conversations.

Installation

Via Plugin Marketplace (Recommended)

/plugin install call-me-cloud@claude-plugins-official

Via npx (Manual)

Add to your MCP settings (.mcp.json or Claude Code config):

{
  "mcpServers": {
    "call-me-cloud": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "CALLME_CLOUD_URL": "https://your-server.railway.app",
        "CALLME_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CALLME_CLOUD_URL | Yes | Your Call-Me Cloud server URL | | CALLME_API_KEY | Yes | API key for authentication |

Available Tools

initiate_call

Start a phone call with the user.

initiate_call({ message: "Hey, I finished the refactor. Want me to walk through it?" })

Returns: { callId, response } - The call ID and the user's spoken response.

continue_call

Send a follow-up message and wait for response.

continue_call({ call_id: "call-1", message: "Should I also update the tests?" })

speak_to_user

Speak a message without waiting for a response.

speak_to_user({ call_id: "call-1", message: "Give me a moment to check that..." })

end_call

End the call with a closing message.

end_call({ call_id: "call-1", message: "Sounds good, I'll get started. Talk soon!" })

send_message

Send a WhatsApp message and wait for the user's reply.

send_message({ message: "The deploy finished. Want me to run the smoke tests?" })

Returns: { messageId, response } - The message ID and the user's text response.

Requirements

• Node.js 18+
• A deployed Call-Me Cloud server
• Twilio account for phone calls
• OpenAI API key (for speech-to-text and text-to-speech)

How It Works

Claude Code  -->  This MCP Client  -->  Your Cloud Server  -->  Phone Call / WhatsApp
   (stdio)          (REST API)              (Twilio)           (to you)

1. Claude decides to call or message you using one of the MCP tools
2. This client forwards the request to your cloud server
3. The server initiates a phone call via Twilio or sends a WhatsApp message
4. Audio is processed through OpenAI's real-time API (for calls)
5. Your response is transcribed/received and returned to Claude

Server Setup

See the main Call-Me Cloud repository for server deployment instructions.

License

MIT