whatsapp-mcp
WhatsApp MCP server
- 6.7k stars
- 1.4k forks
- 261 open issues
- Language: Go
- License: MIT
- updated
Install
git clone https://github.com/lharries/whatsapp-mcp{
"mcpServers": {
"whatsapp-mcp": {
"command": "whatsapp-mcp"
}
}
}{
"mcpServers": {
"whatsapp-mcp": {
"command": "whatsapp-mcp"
}
}
}- Run the command above in your terminal (Claude Code), or paste the JSON config into claude_desktop_config.json (Claude Desktop).
- Replace any <placeholder> values with your API keys or paths.
- Restart Claude. The MCP server and its tools appear automatically.
Install the binary first: go install github.com/lharries/whatsapp-mcp@latest (make sure it ends up on your PATH).
Editor's note
WhatsApp MCP Server connects a personal WhatsApp account to Claude Desktop (and Cursor) through the Model Context Protocol, using a two-component architecture: a Go bridge built on the whatsmeow library that authenticates via QR code scan and stores message history locally in SQLite, and a Python MCP server that exposes twelve tools to Claude. Those tools cover reading and searching messages across individual and group chats, retrieving contact information, and sending text, images, videos, documents, and audio files. Audio messages have a notable detail: the server automatically converts non-Opus audio to the required .ogg format when FFmpeg is installed, enabling proper WhatsApp voice message playback. All message data remains in a local SQLite database and is only forwarded to Claude when a tool call explicitly requests it. The project targets individuals who want to interact with their personal WhatsApp history and contacts through Claude's conversational interface. The README includes a prompt injection warning relevant to any MCP server that handles private message data.
MCP Servers overview
What people ask about whatsapp-mcp
What is lharries/whatsapp-mcp?
lharries/whatsapp-mcp is mcp servers for the Claude AI ecosystem. WhatsApp MCP server It has 6.7k GitHub stars and its last recorded update is dated 2025-07-13.
How do I install whatsapp-mcp?
You can install whatsapp-mcp by cloning the repository (https://github.com/lharries/whatsapp-mcp) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is lharries/whatsapp-mcp safe to use?
Our security agent has analyzed lharries/whatsapp-mcp and assigned a Trust Score of 67/100 (tier: OK). See the full breakdown of passed checks and flags on this page.
Who maintains lharries/whatsapp-mcp?
lharries/whatsapp-mcp is maintained by lharries. The last recorded GitHub activity is dated 2025-07-13, with 261 open issues.
Are there alternatives to whatsapp-mcp?
Yes. On ClaudeWave you can browse similar mcp servers at /categories/mcp, sorted by popularity or recent activity.