WhatsApp Web MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add mcp-whatsapp-web -- npx -y mcp-whatsapp-web

{
  "mcpServers": {
    "mcp-whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ]
    }
  }
}

[mcp_servers.mcp-whatsapp-web]
command = "npx"
args = ["-y", "mcp-whatsapp-web"]

{
  "mcpServers": {
    "mcp-whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ]
    }
  }
}

{
  "servers": {
    "mcp-whatsapp-web": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: WHATSAPP_BACKEND (WhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing), BAILEYS_SESSION_DIR (Baileys credentials and synchronized history directory (default: <working directory>/baileys-sessions). Use a private absolute path, owned by one server process), LOG_LEVEL (Log level for the log file (logs/mcp-whatsapp.log)), LOG_STDERR_LEVEL (Log level for stderr (visible in most MCP client logs)), WHATSAPP_HEADLESS (webjs only: set to false to show the browser window instead of running headless), WHATSAPP_NO_SANDBOX (webjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default), BROWSER_EXECUTABLE_PATH (webjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs), WHATSAPP_SESSION_DIR (webjs only: persistent browser profile directory (default: <working directory>/whatsapp-sessions)), WHATSAPP_PAIRING_PHONE_NUMBER (Phone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code), FFMPEG_PATH (Path to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)), WA_WEB_VERSION (webjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client), HEALTH_CHECK_INTERVAL_MS (webjs only: connection health check interval in milliseconds (<=0 disables)), TOOL_READY_TIMEOUT_MS (How long tool calls wait for the WhatsApp client to become ready before erroring), MCP_HTTP_PORT (When set, additionally exposes the MCP endpoint at http://127.0.0.1:<port>/mcp (Streamable HTTP) from the same process), MCP_HTTP_HOST (Bind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)), MCP_OAUTH (Enable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form).