whatsapp-mcp

Connect Claude Desktop to WhatsApp. Send & receive messages, manage groups, share media — all through natural conversation with Claude.

• Zero-config first launch — auto-detects your WhatsApp Web session from Chrome
• Multi-profile — switch between WhatsApp accounts
• Full messaging — send, read, search, reply, forward, react
• Media support — send images/documents, download attachments
• Group management — create groups, add/remove members, get info
• Cross-platform — Windows, macOS, Linux
• Auto-reconnect — recovers from disconnections automatically

git clone https://github.com/Shloimy15e/whatsapp-mcp.git
cd whatsapp-mcp
powershell -ExecutionPolicy Bypass -File install.ps1

git clone https://github.com/Shloimy15e/whatsapp-mcp.git
cd whatsapp-mcp
chmod +x install.sh && ./install.sh

1. Clone this repo and cd into it
2. Run PUPPETEER_SKIP_DOWNLOAD=true npm install
3. Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "whatsapp": {
      "command": "node",
      "args": ["/full/path/to/whatsapp-mcp/server.mjs"]
    }
  }
}

1. Restart Claude Desktop

• Node.js 18+ (download)
• Google Chrome (used by the WhatsApp Web engine)
• Claude Desktop (download)

On first launch, the MCP server:

1. Scans your Chrome profiles for an existing WhatsApp Web session
2. If found, clones the session data so Chrome doesn't need to stay open
3. Connects to WhatsApp headlessly (no visible browser window)
4. If no session is found, you can ask Claude to set up a new one via QR code

| Tool | Description | |------|-------------| | whatsapp_setup | Manage profiles (add, remove, switch, scan Chrome, clone session) | | whatsapp_status | Conne