How do I install WhatsApp Web MCP Server?

Pick a client above and copy the generated config. Cursor and VS Code also have a deep link when the server can run locally or remotely.

Is WhatsApp Web MCP Server official?

No. Registry-listed is not the same as vendor-official. Read the methodology for the difference.

How is the trust score calculated?

This listing scores 50 (Fair). The formula is published on the methodology page.

MCPpedia

WhatsApp Web MCP Server MCP Server | MCPpedia

WhatsApp Web MCP Server MCP Server

Name: WhatsApp Web MCP Server
Author: mario-andreschak

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

Tools Versions Alternatives

Registrymario-andreschak

50Fair

Install

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mario-andreschak-mcp-whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web@1.2.0"
      ],
      "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": ""
      }
    }
  }
}

Install guide

Related servers

kordoc

83Excellent

Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX, PPTX) to Markdown; fill forms, diff, render.

Registrychrisryugj2.5K stars44.2K/wk

trace-mcp

78Good

Code graph MCP: 81 languages, 88 frameworks, 72.7% fewer PR-review tokens, comprehension at parity

Environment

Name	Required	Notes
WHATSAPP_BACKEND	No	WhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
BAILEYS_SESSION_DIR	No	Baileys credentials and synchronized history directory (default: <working directory>/baileys-sessions). Use a private absolute path, owned by one server process.
LOG_LEVEL	No	Log level for the log file (logs/mcp-whatsapp.log)
LOG_STDERR_LEVEL	No	Log level for stderr (visible in most MCP client logs)
WHATSAPP_HEADLESS	No	webjs only: set to false to show the browser window instead of running headless
WHATSAPP_NO_SANDBOX	No	webjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
BROWSER_EXECUTABLE_PATH	No	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	No	webjs only: persistent browser profile directory (default: <working directory>/whatsapp-sessions)
WHATSAPP_PAIRING_PHONE_NUMBER	No	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	No	Path to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
WA_WEB_VERSION	No	webjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
HEALTH_CHECK_INTERVAL_MS	No	webjs only: connection health check interval in milliseconds (<=0 disables)
TOOL_READY_TIMEOUT_MS	No	How long tool calls wait for the WhatsApp client to become ready before erroring
MCP_HTTP_PORT	No	When set, additionally exposes the MCP endpoint at http://127.0.0.1:<port>/mcp (Streamable HTTP) from the same process
MCP_HTTP_HOST	No	Bind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
MCP_OAUTH	No	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

WhatsApp Web MCP Server MCP Server

Install

Related servers

kordoc

trace-mcp

Environment

Tools

About

FAQ

Reviews

Firecrawl MCP Server

pagespeed-insights-mcp

Hive Intelligence MCP

Formhaus