Get started

Set up WhatsApp MCP — Hebrew-Compatible Fork

Clone the fork

Clone this fork — it includes Unicode search fixes and dual-bridge support not in the upstream repo.

bash

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

Build and start the Go bridge

The Go bridge authenticates with WhatsApp Web and stores messages in SQLite. First run shows a QR code — scan it with your phone.

bash

cd whatsapp-bridge && go build && ./whatsapp-bridge

*Default port: 8741 (personal). For business: WHATSAPP_BRIDGE_PORT=8742 go run main.go

Start the Python MCP server

The MCP server connects to the SQLite database and exposes 13 tools. Auto-detects business bridge if present.

bash

cd whatsapp-mcp-server && uv run main.py

*Requires Python 3.11+ and uv. Set WHATSAPP_OWNER_JID to restrict sends to self only.

Configure MCP

Add the WhatsApp MCP server to Claude Code or Cursor.

json

// ~/.claude/settings.json
{
  "mcpServers": {
    "whatsapp": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/whatsapp-mcp-server",
        "run", "main.py"
      ]
    }
  }
}

Search your messages

Try a Hebrew search to verify Unicode support. The instr()-based queries work for any script.

bash

search_contacts(query: "שלום")

*Also works: list_messages, get_chat, list_chats, download_media, send_message, send_file, send_audio_message.