Skip to content
Cursor

WhatsApp Web MCP Server for Cursor

io.github.mario-andreschak/mcp-whatsapp-web

WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts

client:Cursor transport:stdio runtime:npm

Install WhatsApp Web MCP Server in Cursor

~/.cursor/mcp.json · windows: %USERPROFILE%\.cursor\mcp.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

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

Use .cursor/mcp.json in a project root instead to scope it to that project. Cursor merges both. Cursor docs

WhatsApp Web MCP Server in other clients