WhatsApp Web MCP Server

WhatsApp Web MCP Server is a local MCP server: WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts. Install it from npm as mcp-whatsapp-web.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add mcp-whatsapp-web -e WHATSAPP_BACKEND=... -e BAILEYS_SESSION_DIR=... -e LOG_LEVEL=... -e LOG_STDERR_LEVEL=... -e WHATSAPP_HEADLESS=... -e WHATSAPP_NO_SANDBOX=... -e BROWSER_EXECUTABLE_PATH=... -e WHATSAPP_SESSION_DIR=... -e WHATSAPP_PAIRING_PHONE_NUMBER=... -e FFMPEG_PATH=... -e WA_WEB_VERSION=... -e HEALTH_CHECK_INTERVAL_MS=... -e TOOL_READY_TIMEOUT_MS=... -e MCP_HTTP_PORT=... -e MCP_HTTP_HOST=... -e MCP_OAUTH=... -- npx -y mcp-whatsapp-web

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "mcp-whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "WHATSAPP_BACKEND": "...",
        "BAILEYS_SESSION_DIR": "...",
        "LOG_LEVEL": "...",
        "LOG_STDERR_LEVEL": "...",
        "WHATSAPP_HEADLESS": "...",
        "WHATSAPP_NO_SANDBOX": "...",
        "BROWSER_EXECUTABLE_PATH": "...",
        "WHATSAPP_SESSION_DIR": "...",
        "WHATSAPP_PAIRING_PHONE_NUMBER": "...",
        "FFMPEG_PATH": "...",
        "WA_WEB_VERSION": "...",
        "HEALTH_CHECK_INTERVAL_MS": "...",
        "TOOL_READY_TIMEOUT_MS": "...",
        "MCP_HTTP_PORT": "...",
        "MCP_HTTP_HOST": "...",
        "MCP_OAUTH": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Node.js 18+ (runs with npx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: WHATSAPP_BACKEND, BAILEYS_SESSION_DIR, LOG_LEVEL, LOG_STDERR_LEVEL, WHATSAPP_HEADLESS, WHATSAPP_NO_SANDBOX, BROWSER_EXECUTABLE_PATH, WHATSAPP_SESSION_DIR, WHATSAPP_PAIRING_PHONE_NUMBER, FFMPEG_PATH, WA_WEB_VERSION, HEALTH_CHECK_INTERVAL_MS, TOOL_READY_TIMEOUT_MS, MCP_HTTP_PORT, MCP_HTTP_HOST, MCP_OAUTH