Overview

The WhatsApp MCP Server brings WhatsApp Business messaging capabilities to AI assistants. With over 2 billion users worldwide, WhatsApp is the most popular messaging platform globally. This server enables AI models to send and receive messages, manage business conversations, automate customer communications, and integrate with CRM workflows through the WhatsApp Business API.

Community MCP Server:

Uses the official WhatsApp Business API via a Meta Business Account

Key Features

📤

Send Messages

Send text, image, document, and interactive messages to any WhatsApp number

📥

Receive & Read

Read incoming messages, process message history, and handle incoming media

🤖

Auto-Response

Set up automated replies, smart responses, and conversational AI for customer support

📋

Template Management

Create and send pre-approved message templates for notifications and alerts

📊

Campaign Management

Send bulk messages, track delivery status, and manage customer segments

🔗

CRM Integration

Sync conversations with CRM systems, log interactions, and manage customer profiles

Available Tools

Quick Reference

Tool	Purpose
`send_message`	Send a text message to a WhatsApp number
`send_template`	Send a pre-approved message template
`read_messages`	Read recent messages from a conversation
`list_conversations`	List active WhatsApp conversations
`send_media`	Send images, documents, or audio files
`create_campaign`	Create and send a bulk messaging campaign

Detailed Usage

send_message▶

Send a text message to any WhatsApp number.

{
  "to": "+1234567890",
  "message": "Hi there! Thanks for reaching out. How can I help you today?"
}

send_template▶

Send a pre-approved message template with optional parameter substitution.

{
  "to": "+1234567890",
  "template_name": "order_confirmation",
  "parameters": ["ORD-12345", "2025-05-10"]
}

read_messages▶

Read recent messages from a specific conversation thread.

{
  "conversation_id": "wa_12345",
  "limit": 50
}

send_media▶

Send media files including images, documents, PDFs, or audio messages.

{
  "to": "+1234567890",
  "media_url": "https://example.com/invoice.pdf",
  "media_type": "document",
  "caption": "Your invoice is attached."
}

Installation

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "whatsapp-mcp"],
      "env": {
        "WHATSAPP_API_KEY": "your_api_key",
        "WHATSAPP_PHONE_ID": "your_phone_number_id"
      }
    }
  }
}

WhatsApp Business API Required:

You'll need a Meta Business Account with WhatsApp Business API access. Set up your account at Meta Business Suite.

Use Cases

Customer Support

Power AI customer support agents that can handle common inquiries, escalate issues, and provide 24/7 service.

Order Notifications

Send automated order confirmations, shipping updates, and delivery notifications via WhatsApp.

Marketing Campaigns

Create targeted messaging campaigns with personalized offers and promotions.

Appointment Reminders

Automate appointment scheduling, reminders, and follow-ups for service-based businesses.

WhatsApp MCP Server