WhatsApp Business MCP Server

An MCP (Model Context Protocol) server that connects AI agents to the WhatsApp Business Cloud API. Send messages, manage contacts, handle customer support — all through AI.

Features

Messaging (7 tools)

• send_text_message — Send text messages to any WhatsApp number
• send_image_message — Send images via URL with optional captions
• send_document — Send PDFs, invoices, and files
• send_template_message — Send pre-approved template messages
• send_location — Send location pins with name and address
• send_reaction — React to messages with emojis
• mark_as_read — Mark messages as read (blue ticks)

Interactive Messages (2 tools)

• send_button_message — Send messages with up to 3 reply buttons
• send_list_message — Send interactive list menus with sections

Business Management (4 tools)

• get_business_profile — View your WhatsApp Business profile
• update_business_profile — Update about, description, address, email, websites
• get_message_templates — List all approved message templates
• get_media_url — Get download URLs for received media

Total: 13 tools

Quick Start

1. Install

npm install whatsapp-mcp-server

2. Configure

Create a .env file:

WA_ACCESS_TOKEN=your_access_token
WA_PHONE_NUMBER_ID=your_phone_number_id
WA_BUSINESS_ID=your_business_id

Get these from Meta Developer Portal.

3. Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["whatsapp-mcp-server"],
      "env": {
        "WA_ACCESS_TOKEN": "your_token",
        "WA_PHONE_NUMBER_ID": "your_id"
      }
    }
  }
}

4. Use with any MCP client

npx whatsapp-mcp-server

Example Prompts

Once connected, you can ask your AI agent:

• "Send a message to +60123456789 saying 'Your order has been shipped'"
• "Send our product catalog PDF to this customer"
• "Send a button message asking if the customer wants to schedule or cancel"
• "Mark all unread messages as read"
• "Update our business description to include new opening hours"
• "Send the hello_world template to +60123456789"

Getting WhatsApp Business API Access

1. Go to developers.facebook.com
2. Create a new app → Select "Business" type
3. Add WhatsApp product to your app
4. Get your Phone Number ID and Access Token from the WhatsApp dashboard
5. For production: verify your business and get a permanent System User token

Requirements

• Node.js 18+
• WhatsApp Business Cloud API access (free tier available)
• Meta Developer account

License

MIT