💬 WhatsApp Bridge MCP Server

Official Model Context Protocol (MCP 2.0) server enabling Claude Desktop, Claude Code, and autonomous AI agents to dispatch direct WhatsApp messages, documents, media, urgent build alerts, and report summaries to personal or team phones.

💡 The Problem

AI agents can manipulate files, browse the web, and run terminal commands, but they lack a seamless way to ping developers on WhatsApp when a 3-hour build finishes, a production error fires, or human approval is needed. Traditional solutions rely on expensive third-party enterprise providers (Twilio / MessageBird) with heavy monthly fees.

Related MCP server: WAHA WhatsApp MCP Server

🚀 The Solution

mcp-whatsapp-bridge gives Claude native tools to route text, rich alerts, and documents directly through any local WhatsApp session (Baileys / Puppeteer / self-hosted gateway) or direct webhook endpoints.

🛠️ Available MCP Tools

📦 Setup & Configuration

Environment Variables

1. Claude Desktop Integration

Add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "whatsapp-bridge": {
      "command": "python3",
      "args": ["/path/to/mcp-whatsapp-bridge/server.py"],
      "env": {
        "WHATSAPP_GATEWAY_URL": "http://localhost:3001/send",
        "WHATSAPP_DEFAULT_PHONE": "+6281234567890",
        "WHATSAPP_API_KEY": "optional_bearer_token"
      }
    }
  }
}

2. Claude Code CLI Integration

claude mcp add whatsapp-bridge -- python3 /path/to/server.py

3. CLI Diagnostics Mode

Test connection to your gateway without launching the full MCP loop:

python3 server.py --test
python3 server.py --test --json

🧪 Running Tests

python3 tests/test_server.py

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.