WhatsApp MCP Server

A Model Context Protocol (MCP) server for WhatsApp integration. Send messages, search conversations, and access your WhatsApp history through Claude and other LLMs.
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber

A Model Context Protocol (MCP) server for WhatsApp integration. Send messages, search conversations, and access your WhatsApp history through Claude and other LLMs.
MCP server enabling LLMs to interact with WhatsApp - send messages with fuzzy name matching, full-text search across conversations, manage chats and contacts, and download media
This MCP server provides 7 tools to interact with your WhatsApp account via the whatsmeow library:
All messages and chats are persisted to a local SQLite database with full-text search capabilities, enabling rich queries and analysis of your WhatsApp history.
# Pull the image
docker pull ghcr.io/eddmann/whatsapp-mcp:latest
# Create directory for persistent storage
mkdir -p whatsapp-store
# Run the container (QR code will be displayed)
docker run -it --rm \
-v "$(pwd)/whatsapp-store:/app/store" \
ghcr.io/eddmann/whatsapp-mcp:latest
On first run, a QR code will be displayed in the terminal:
store/whatsapp.db and persists across restartsstore/messages.db with FTS5 full-text searchstore/<chatJID>/ directoriesImportant: Mount a volume to
/app/storeto persist session data and messages across container restarts.
Add to your configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"whatsapp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"/ABSOLUTE/PATH/TO/whatsapp-store:/app/store",
"ghcr.io/eddmann/whatsapp-mcp:latest"
]
}
}
}
{
"mcpServers": {
"whatsapp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"/ABSOLUTE/PATH/TO/whatsapp-store:/app/store",
"-e",
"LOG_LEVEL=DEBUG",
"ghcr.io/eddmann/whatsapp-mcp:latest"
]
}
}
}
DB_DIR - Directory for SQLite databases and downloaded media - default: storeLOG_LEVEL - Logging level (DEBUG, INFO, WARN, ERROR) - default: INFOFFMPEG_PATH - Path to ffmpeg binary for audio conversion - default: ffmpegAsk Claude to interact with your WhatsApp data using natural language.
"Send a message to John saying I'll be there in 10 minutes"
"Send a photo from ~/Desktop/photo.jpg to Bob"
"Send this audio recording to the Project Team group"
"Reply to that message from Sarah saying 'Sounds good!'"
Recipient Formats (with fuzzy name matching):
- Contact/group names:
"John","Bob","Project Team"(searches your chat history)- Phone numbers: Without
+(e.g.,447123456789)- Full JID:
[email protected]for contacts,[email protected]for groupsIf multiple matches are found for a name, you'll be prompted to disambiguate using the full JID.
Message Threading:
Reply to specific messages to create threaded conversations. The original message will be quoted in your reply.
"Show me my recent chats"
"List my last 20 messages with John"
"Show the conversation with Dad from yesterday with context"
"Search for all messages mentioning 'project deadline'"
"Find messages from Alice about the meeting"
"Search for 'birthday party' in my group chats"
"Download the latest photo from the Family group"
"Save that video Mick sent me yesterday"
"Catch me up on today's WhatsApp activity"
"Show me what happened in my WhatsApp groups this week"
"What questions have I been asked today?"
MIT License - see LICENSE file for details
This project is not affiliated with, endorsed by, or sponsored by WhatsApp Inc. or Meta Platforms, Inc. Use at your own risk. Ensure compliance with WhatsApp's Terms of Service when using this software.
Inspired by lharries/whatsapp-mcp
MCP server enabling LLMs to interact with WhatsApp - send messages with fuzzy name matching, full-text search across conversations, manage chats and contacts, and download media
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Whatsapp läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. MCP server enabling LLMs to interact with WhatsApp - send messages with fuzzy name matching, full-text search across conversations, manage chats and contacts, and download media