← MCPLookup
Packageactivev1.1.0

WhatsApp Web MCP Server

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

MCP server for WhatsApp via whatsapp-web.js: send/receive messages, media, chats, groups, contacts

mario-andreschak/mcp-whatsapp-web WebsiteUpdated Jul 5, 2026

No blockers found

assessed on 1 of 4 dimensions

  • ProvenanceOrigin linked to a public source repository.Official MCP Registry · as of Jul 5, 2026
    Pass
  • MaintenanceRepository maintenance signals not yet ingested.
    Pending
  • Manifest integrityLive manifest not yet captured — the rug-pull baseline begins at first probe.
    Pending
  • Supply chainPackage vulnerability scan not yet run.
    Pending
  • Behavioral trustNo live endpoint to observe.
    Not applicable

Connect

npm package · v1.1.0 · stdio
npx -y mcp-whatsapp-web
  • 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
    Set to false to show the browser window instead of running headless (debugging aid)
  • BROWSER_EXECUTABLE_PATH
    Browser executable. Chrome and Edge are auto-detected in their standard install locations; set this only to use a specific browser. A real Chrome/Edge is required for sending videos and GIFs.
  • WHATSAPP_SESSION_DIR
    Where the WhatsApp session (browser profile) is stored (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
    Pin the WhatsApp Web version. Only set this if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS
    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

Provenance

  • Official MCP Registry · as of Jul 5, 2026 · registry-tos

Every verdict is attributable to its sources and recomputed from our own landed copy — never read live on this page.