whatsapp-mcp-server

Overview

WA MCP Server connects AI assistants like Claude with the WhatsApp Business API. Send messages, receive replies, manage templates, set up AI chatbots, track analytics, and protect against spam — all through natural language.

You: "Send a message to +56 9 1234 5678 saying the order is ready"
Claude: Message sent! ID: wamid.HBgL...

Why this server?

Quick Start

1. Add to Claude Desktop

Free tier (7 tools, no API key):

{
  "mcpServers": {
    "whatsapp": {
      "type": "url",
      "url": "https://whatsapp-mcp-server.eosspirit.workers.dev/mcp"
    }
  }
}

Pro / Enterprise (with API key):

{
  "mcpServers": {
    "whatsapp": {
      "type": "url",
      "url": "https://whatsapp-mcp-server.eosspirit.workers.dev/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Config file location:

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

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Restart Claude Desktop

3. Start messaging

"Send a text to +1234567890 saying hello"
"Show me my message templates"
"What's my phone quality rating?"
"Configure auto-reply with Groq"

Plans & Pricing

All 43 Tools

Messages (10 tools)

send_text_message send_image_message send_video_message send_audio_message send_document_message send_sticker_message send_location_message send_contact_message send_reaction mark_as_read

Interactive Messages (5 tools) PRO

send_button_message send_list_message send_cta_url_button send_product_message send_product_list_message

Templates (5 tools) PRO

send_template_message list_templates create_template delete_template get_template_status

Media (3 tools) PRO

upload_media get_media_url delete_media

Webhooks (3 tools) PRO

get_recent_messages get_message_status_updates search_conversations

Business Profile (3 tools) PRO

get_business_profile update_business_profile get_phone_numbers

WhatsApp Flows (2 tools) ENTERPRISE

create_flow send_flow_message

Analytics (4 tools) ENTERPRISE

get_conversation_analytics get_phone_quality_rating get_messaging_limits get_delivery_stats

Safety Tools (2 tools)

manage_allowlist get_messaging_safety_status

Enterprise Safety (3 tools) ENTERPRISE

get_message_audit_log set_custom_rate_limits export_safety_report

AI Auto-Reply (3 tools) ENTERPRISE

configure_auto_reply get_auto_reply_status clear_conversation_history

See full tool reference with usage examples.

AI Auto-Reply Chatbot

Enterprise customers can enable AI-powered automatic replies. When a customer messages you on WhatsApp, the server calls an AI provider and sends the response back automatically.

5 supported providers:

Each client uses their own AI API key — no AI costs on our side.

Customer: "Hola, cuanto cuesta?"
Bot: "Hola! Tenemos planes Free, Pro ($29/mes) y Enterprise ($99/mes).
      Visita https://mysite.com para mas detalles."

Customer: "Tienen envio gratis?"
Bot: "Si, envio gratuito en pedidos mayores a $50."

Anti-Spam Protection

Every outbound message passes through MessageGuard before sending. No bad prompt can turn into spam.

Architecture

Claude / AI Assistant
       |
       v
+---------------------------------+
|   Cloudflare Worker (Edge)      |
|   - MCP Protocol (JSON-RPC)    |
|   - Auth + API Keys + Tiers    |
|   - Rate Limiting + Anti-Spam  |
|   - AI Auto-Reply Engine       |
|   - Billing (Lemonsqueezy)     |
+--------+----------+------------+
         |          |
    +----+----+  +--+-------------+
    | WhatsApp|  | Durable Objects |
    | Cloud   |  | (webhooks,      |
    | API     |  |  sessions)      |
    +---------+  +--+---------+----+
                    |         |
                +---+---+ +---+---+
                |  D1   | |  KV   |
                | logs  | | cache |
                +-------+ +-------+

Tech stack: TypeScript (strict) | Cloudflare Workers | D1 | KV | Durable Objects | Zod | Vitest

Self-Hosting

git clone https://github.com/spirit122/whatsapp-mcp-server.git
cd whatsapp-mcp-server
npm install

# Create Cloudflare resources
wrangler d1 create whatsapp-mcp-db
wrangler kv namespace create CACHE

# Set secrets
wrangler secret put WHATSAPP_ACCESS_TOKEN
wrangler secret put WHATSAPP_PHONE_NUMBER_ID
wrangler secret put WHATSAPP_BUSINESS_ACCOUNT_ID
wrangler secret put WHATSAPP_WEBHOOK_VERIFY_TOKEN
wrangler secret put META_APP_SECRET

# Deploy
wrangler d1 execute whatsapp-mcp-db --remote --file=./schemas/d1-schema.sql
wrangler deploy

Full self-hosting guide: spirit122.github.io/whatsapp-mcp-server/self-hosting.html

Development

wrangler dev          # Run locally
npm test              # Run 72 tests
npm run typecheck     # TypeScript strict check

API Endpoints

Support

License

MIT

Built by Ricardo Sepúlveda

Website | Product Hunt