WhatsApp Web MCP Server

stdio

MCP server for WhatsApp via whatsapp-web.js: send/receive messages, media, chats, groups, 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": {
        "LOG_LEVEL": "info",
        "LOG_STDERR_LEVEL": "warn",
        "WHATSAPP_HEADLESS": "",
        "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