MCP server/communication

WhatsApp Business MCP Server

The most complete MCP Server for WhatsApp Business Cloud API.

★ 3spirit122/whatsapp-mcp-server ↗by spirit122updated
1

Add it to Claude Code

claude mcp add --transport http whatsapp-mcp-889a https://whatsapp-mcp-server.eosspirit.workers.dev/mcp
2

Make your agent remember this setup

whatsapp-mcp-889a's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session. 

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

  • Send various message types including text, images, video, and documents
  • Manage WhatsApp templates including creation and status checking
  • Handle interactive messages like buttons, lists, and product catalogs
  • Upload and manage media files directly on WhatsApp servers
  • Mark messages as read and react to messages with emojis

Tools 23

send_text_messageSend text with URL preview and reply support
send_image_messageSend image via URL or media ID
send_video_messageSend video (MP4, 3GPP)
send_audio_messageSend audio (AAC, MP3, OGG)
send_document_messageSend document (PDF, etc.)
send_sticker_messageSend sticker (WEBP)
send_location_messageSend location with coordinates
send_contact_messageSend contact cards
send_reactionReact to a message with emoji
mark_as_readMark message as read
send_button_messageUp to 3 reply buttons for quick choices
send_list_messageScrollable list with sections and rows
send_cta_url_buttonCall-to-action URL button
send_product_messageSingle product from your catalog
send_product_list_messageMulti-product catalog view
send_template_messageSend approved template with dynamic parameters
list_templatesList all your message templates
create_templateCreate a new template
delete_templateDelete a template by name
get_template_statusCheck if a template is approved, pending, or rejected
upload_mediaUpload file to WhatsApp servers
get_media_urlGet download URL for a media file
delete_mediaDelete uploaded media

Environment Variables

X-API-KeyLicense key obtained after purchasing a Pro or Enterprise plan

Try it

→Send a message to +56 9 1234 5678 saying the order is ready
→List all my current WhatsApp message templates and their approval status
→Upload the file at path/to/document.pdf to WhatsApp and get the media ID
→Send a button message to the customer asking if they want to confirm their appointment
→Mark the last message from +56 9 1234 5678 as read
Original README from spirit122/whatsapp-mcp-server

WhatsApp Business MCP Server

The most complete MCP Server for WhatsApp Business Cloud API. 43 tools | 8 modules | Hosted on Cloudflare Workers | Zero installation

Built by spirit122

What is this?

This MCP Server lets you control WhatsApp Business directly from Claude AI. Send messages, receive replies, manage templates, track analytics — all through natural language.

Example: Just tell Claude "Send a message to +56 9 1234 5678 saying the order is ready" and it does it.

Get Started in 3 Steps

Step 1: Choose Your Plan

Free Pro Enterprise
Price $0 $27,000 CLP/mo $92,000 CLP/mo
Core messages (text, image, video, audio, docs) 10 tools 10 tools 10 tools
Templates (send, create, list, delete) 5 tools 5 tools 5 tools
Media (upload, download, delete) 3 tools 3 tools 3 tools
Business profile 3 tools 3 tools 3 tools
Interactive messages (buttons, lists, products) - 5 tools 5 tools
Webhooks (receive messages, search conversations) - 3 tools 3 tools
WhatsApp Flows (forms, surveys in chat) - 2 tools 2 tools
Analytics (metrics, quality, delivery stats) - 4 tools 4 tools
Support Community Email Priority + SLA
Safety tools (allowlist, spam config) 2 tools 2 tools 5 tools
Enterprise safety (audit log, custom limits, reports) - - 3 tools
AI Auto-Reply (chatbot with 5 providers) - - 3 tools
Anti-spam protection Strict Moderate Fully customizable
Rate limit 100/hr 1,000/hr 10,000/hr
Total tools 5 25 38

Buy Pro: Click here to subscribe

Buy Enterprise: Click here to subscribe

Step 2: Get Your API Key

After purchasing, you will receive a license key via email from Lemonsqueezy. This is your API key.

You can also retrieve it at any time:

GET https://whatsapp-mcp-server.eosspirit.workers.dev/billing/api-key?email=YOUR_EMAIL

Step 3: Connect to Claude Desktop

  1. Open Claude Desktop
  2. Click the gear icon (Settings) > Developer > Edit Config
  3. This opens claude_desktop_config.json. Paste the config below.
  4. Restart Claude Desktop

Config file location:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Free tier (no API key needed):

{
  "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_HERE"
      }
    }
  }
}

That's it! Now just ask Claude to send messages, check analytics, or anything else.

All 35 Tools

Module 1: Messages (10 tools)

Tool Description
send_text_message Send text with URL preview and reply support
send_image_message Send image via URL or media ID
send_video_message Send video (MP4, 3GPP)
send_audio_message Send audio (AAC, MP3, OGG)
send_document_message Send document (PDF, etc.)
send_sticker_message Send sticker (WEBP)
send_location_message Send location with coordinates
send_contact_message Send contact cards
send_reaction React to a message with emoji
mark_as_read Mark message as read (blue checkmarks)

Module 2: Interactive Messages (5 tools) `PRO`

Tool Description
send_button_message Up to 3 reply buttons for quick choices
send_list_message Scrollable list with sections and rows
send_cta_url_button Call-to-action URL button
send_product_message Single product from your catalog
send_product_list_message Multi-product catalog view

Module 3: Templates (5 tools)

Tool Description
send_template_message Send approved template with dynamic parameters
list_templates List all your message templates
create_template Create a new template (requires Meta approval)
delete_template Delete a template by name
get_template_status Check if a template is approved, pending, or rejected

Module 4: Media (3 tools)

Tool Description
upload_media Upload file to WhatsApp servers (max 100MB)
get_media_url Get download URL for a media file (expires in 5 min)
delete_media Delete uploaded media

Frequently Asked Questions

What are the key features of WhatsApp Business MCP?

Send various message types including text, images, video, and documents. Manage WhatsApp templates including creation and status checking. Handle interactive messages like buttons, lists, and product catalogs. Upload and manage media files directly on WhatsApp servers. Mark messages as read and react to messages with emojis.

What can I use WhatsApp Business MCP for?

Automating customer support responses directly from the Claude interface. Managing business communication workflows without leaving the AI chat. Sending personalized template-based notifications to customers. Handling media file uploads for business catalog updates.

How do I install WhatsApp Business MCP?

Install WhatsApp Business MCP by running: Add the provided URL configuration to your claude_desktop_config.json file.

What MCP clients work with WhatsApp Business MCP?

WhatsApp Business MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep WhatsApp Business MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest

Related MCP Servers

Vexa
Self-hosted meeting intelligence platform
communication2.7K stars
Claude Peers
Let your Claude Code instances find each other and talk.
communication2.2K stars
Wenyan MCP Server
Bridge AI writing and WeChat Official Account publishing with Markdown.
communication1.3K stars
KeyID Agent Kit
Give Claude, Cursor, or any MCP client a real email address. Free.
communication664 stars
Instagram MCP Server
Integrate with Instagram's Graph API for AI-driven account management.
communication177 stars
WeChat MCP Server
A WeChat robot server that enables AI agents to send and receive messages.
communication108 stars