WhatsApp Web MCP Server

stdio

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

Getting Started

npx @getmcp/cli add io.github.mario-andreschak/mcp-whatsapp-web

Requires Node.js 18+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.mario-andreschak/mcp-whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "WHATSAPP_BACKEND": "webjs",
        "BAILEYS_SESSION_DIR": "",
        "LOG_LEVEL": "info",
        "LOG_STDERR_LEVEL": "warn",
        "WHATSAPP_HEADLESS": "",
        "WHATSAPP_NO_SANDBOX": "false",
        "BROWSER_EXECUTABLE_PATH": "",
        "WHATSAPP_SESSION_DIR": "",
        "WHATSAPP_PAIRING_PHONE_NUMBER": "",
        "FFMPEG_PATH": "",
        "WA_WEB_VERSION": "",
        "HEALTH_CHECK_INTERVAL_MS": "60000",
        "TOOL_READY_TIMEOUT_MS": "45000",
        "MCP_HTTP_PORT": "",
        "MCP_HTTP_HOST": "127.0.0.1",
        "MCP_OAUTH": ""
      }
    }
  }
}

Claude Desktop MCP documentation