whatsapp-mcp

Overview

This MCP server bridges WhatsApp and AI assistants by exposing 7 tools, 4 prompts, and 4 resources through the Model Context Protocol. It connects to WhatsApp Web via the unofficial whatsmeow library, storing all messages locally in SQLite. The server provides comprehensive search capabilities, timezone support, and secure API key authentication. With both Docker and local installation options, it integrates seamlessly with MCP-compatible clients like Claude Desktop.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• list_chats

  Browse WhatsApp conversations ordered by recent activity

  Try:Show me my recent conversationsTry:List all my WhatsApp chats
• get_chat_messages

  Read messages from a specific chat with pagination and sender filtering

  Try:Get messages from the Tech Team groupTry:Show recent messages from Maria
• search_messages

  Search across all chats with pattern matching and wildcards

  Try:Search for messages about budget meetingTry:Find all messages containing 'deadline'
• find_chat

  Locate a chat by name with fuzzy search support

  Try:Find the chat with JoãoTry:Show me the Tech Team conversation
• send_message

  Send WhatsApp messages to any chat or group

  Try:Tell Maria I'll be 10 minutes lateTry:Send a message to the work group about the meeting
• load_more_messages

  Fetch older message history from WhatsApp servers on demand

  Try:Load more messages from last weekTry:Get the conversation history from last month
• get_my_info

  Get your WhatsApp profile information including JID, name, status, and picture

  Try:Show my WhatsApp profileTry:Get my WhatsApp account details

Comparable tools

Installation

git clone https://github.com/felipeadeildo/whatsapp-mcp
cd whatsapp-mcp
cp .env.example .env
# Edit .env with your settings

docker compose up -d

{
  "mcpServers": {
    "whatsapp": {
      "url": "http://localhost:8080/mcp/your-secret-api-key",
      "transport": "http"
    }
  }
}

FAQ

Is this WhatsApp official?

No, this is an unofficial project using WhatsApp's unofficial Web API. It's not affiliated with WhatsApp or Meta.

Where are messages stored?

All messages are stored locally in SQLite databases in the ./data/ directory. Media files are stored in ./data/media/

How does the authentication work?

You scan a QR code with WhatsApp to link the device, then use an API key for MCP client authentication.

Compare whatsapp-mcp with