MCP Hub › Developer Tools › WhatsApp Web MCP Server

WhatsApp Web MCP Server MCP server

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

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

🛠 Developer Toolsnpmv1.2.0
Open in MCP HubGitHub repository ↗Website ↗

How to install WhatsApp Web MCP Server

npm

claude mcp add mcp-whatsapp-web -- npx -y [email protected]

Or add it to your MCP config (Claude Desktop, Cursor, VS Code):

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

Environment variables:
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

Replace placeholders in <angle brackets> with your own values. Review what a server can access before you enable it.

Details

Version
1.2.0
Published
2026-09-05
Updated
2026-09-05
Namespace
io.github.mario-andreschak
Source
mario-andreschak/mcp-whatsapp-web

Similar developer tools servers