Skip to main content
ClaudeWave

WhatsApp MCP server

MCP Servers5.9k stars1.2k forksGoMITUpdated 1y ago
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.

ClaudeWave Trust Score
85/100
Trusted
Passed
  • Open-source license (MIT)
  • Healthy fork ratio
  • Topics declared
  • Mature repo (>1y old)
  • Documented (README)
Flags
  • !Inactive (>180d)
Last scanned: 6/11/2026
Install in Claude Code / Claude Desktop
Method: Manual · whatsapp-mcp
Claude Code CLI
git clone https://github.com/lharries/whatsapp-mcp
claude_desktop_config.json (Claude Desktop)
{
  "mcpServers": {
    "whatsapp-mcp": {
      "command": "whatsapp-mcp"
    }
  }
}
1. Run the command above in your terminal (Claude Code), or paste the JSON config into claude_desktop_config.json (Claude Desktop).
2. Replace any <placeholder> values with your API keys or paths.
3. 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).
Use cases

MCP Servers overview

README preview not available. Visit the repo on GitHub for full documentation.
aimcpwhatsappwhatsapp-api

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 5.9k GitHub stars and was last updated 1y ago.

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 85/100 (tier: Trusted). 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 from 1y ago, with 220 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.

Deploy whatsapp-mcp to your cloud

Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.

Maintain this repo? Add a badge to your README

Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.

Featured on ClaudeWave: lharries/whatsapp-mcp
[![Featured on ClaudeWave](https://claudewave.com/api/badge/lharries-whatsapp-mcp)](https://claudewave.com/repo/lharries-whatsapp-mcp)
<a href="https://claudewave.com/repo/lharries-whatsapp-mcp"><img src="https://claudewave.com/api/badge/lharries-whatsapp-mcp" alt="Featured on ClaudeWave: lharries/whatsapp-mcp" width="320" height="64" /></a>

More MCP Servers