WhatsApp MCP

What it does

WhatsApp MCP connects your AI assistant directly to your WhatsApp account. It allows the agent to read and send messages, search through years of conversation history using an optimized SQLite FTS5 engine, and manage media files, turning your chat history into a queryable knowledge base.

Tools

• send_message: Send text and media with fuzzy name matching for recipients.
• search_messages: Perform powerful full-text searches across all conversations with boolean operators.
• list_chats: Browse recent conversations with pagination and filtering.
• list_messages: Retrieve detailed message history for specific contacts or timeframes.
• download_media: Save images, videos, and documents from chats to local storage.
• catch_up: Generate intelligent summaries of recent activity and pending questions.
• get_connection_status: Monitor the link state and database health.

Installation

Run via Docker:

docker run -it --rm -v "$(pwd)/whatsapp-store:/app/store" ghcr.io/eddmann/whatsapp-mcp:latest

Claude Desktop config:

{
  "mcpServers": {
    "whatsapp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/ABSOLUTE/PATH/TO/whatsapp-store:/app/store",
        "ghcr.io/eddmann/whatsapp-mcp:latest"
      ]
    }
  }
}

Supported hosts

Confirmed support for Claude Desktop and other Docker-capable MCP clients.