whatsapp-mcp

WhatsApp MCP server

GitHub Stars

4,788

User Rating

Not Rated

Favorites

0

Views

70

Forks

708

Issues

70

Installation
Difficulty
Advanced
Estimated Time
20-45 minutes

Installation

Installation

Prerequisites

Go: Latest version
Python 3.6+
Anthropic Claude Desktop app (or Cursor)
UV: Install with curl -LsSf https://astral.sh/uv/install.sh | sh
FFmpeg (optional): Needed for sending audio messages

Installation Steps

1. Clone Repository

bash
git clone https://github.com/lharries/whatsapp-mcp.git
cd whatsapp-mcp

2. Run the WhatsApp Bridge

bash
cd whatsapp-bridge
go run main.go
The first time you run it, you will be prompted to scan a QR code.

3. Connect to the MCP Server

Copy the below JSON with the appropriate {{PATH}} values:
json
{
  "mcpServers": {
    "whatsapp": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

4. Restart Claude Desktop / Cursor

Open Claude Desktop and you should now see WhatsApp as an available integration.