Self-hosted WhatsApp MCP server for Claude, Claude Code, Codex and AI agents. Read-only archive, search, deleted messages, Docker and authenticated HTTP.
Quick Install
Copy the config for your editor. Some servers may need additional setup — check the README.
Claude Desktop
Claude Code
Cursor
Add to claude_desktop_config.json:
{
"mcpServers": {
"whatsapp-mcp": {
"command": "uvx",
"args": [
"whatsapp-mcp"
]
}
}
}📋 Copy
Run in terminal:
claude mcp add whatsapp-mcp uvx whatsapp-mcp📋 Copy
Add to .cursor/mcp.json:
{
"mcpServers": {
"whatsapp-mcp": {
"command": "uvx",
"args": [
"whatsapp-mcp"
]
}
}
}📋 Copy
Or install with pip: pip install whatsapp-mcp
README Excerpt
<p align="center"> <img alt="MCP" src="https://img.shields.io/badge/MCP-stdio_%2B_Streamable_HTTP-6f42c1"> <img alt="Go" src="https://img.shields.io/badge/Go-1.25-00ADD8?logo=go&logoColor=white"> <img alt="Python" src="https://img.shields.io/badge/Python-3.11%2B-3776AB?logo=python&logoColor=white"> <img alt="SQLite" src="https://img.shields.io/badge/SQLite-FTS5-003B57?logo=sqlite&logoColor=white">
Tools (10)
get_chat get_contact_chats get_direct_chat_by_contact get_last_interaction get_message_context list_chats list_deleted_messages list_message_events list_messages search_contacts
Topics
ai-agents claude claude-code codex golang mcp model-context-protocol python sqlite whatsapp whatsapp-automation whatsapp-mcp whatsmeow