WhatsApp MCP — AI-Powered WhatsApp Integration
Architecture
The system has two components:
- Go Bridge — Handles WhatsApp Web API connectivity and authentication via QR code
- Python MCP Server — Exposes WhatsApp tools to AI agents via the Model Context Protocol
All messages are stored locally in SQLite for fast search and retrieval.
Available Tools
| Tool | Description |
|---|---|
search_contacts |
Find WhatsApp contacts by name |
get_messages |
Retrieve message history from any chat |
send_message |
Send text messages to contacts or groups |
send_media |
Send images, documents, and audio files |
list_groups |
List all WhatsApp groups |
Prerequisites
- Go 1.19+
- Python 3.6+ with UV package manager
- Claude Desktop, Cursor, or Claude Code
- FFmpeg (optional, for audio conversion)
Setup for Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"whatsapp": {
"command": "uv",
"args": ["--directory", "/path/to/whatsapp-mcp/whatsapp-mcp-server", "run", "main.py"]
}
}
}Safety Note
This connects to your real WhatsApp account. Always review messages before sending through AI agents.
FAQ
Q: What is WhatsApp MCP Server? A: An MCP server that connects AI agents like Claude to your personal WhatsApp account, enabling message search, reading, and sending via natural language.
Q: Is WhatsApp MCP Server free? A: Yes, it's free and open source under the MIT license.
Q: Does it require WhatsApp Business API? A: No, it uses the WhatsApp Web multidevice API — just scan a QR code with your personal WhatsApp.