HotStack

← Back to browse

WhatsApp Web MCP Server

Indexed by io.github.mario-andreschak
View source ↗

About

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

Use this server

Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.

Transportstdio (runs a local command)
Env varsLOG_LEVEL LOG_STDERR_LEVEL WHATSAPP_HEADLESS BROWSER_EXECUTABLE_PATH WHATSAPP_SESSION_DIR WHATSAPP_PAIRING_PHONE_NUMBER FFMPEG_PATH WA_WEB_VERSION HEALTH_CHECK_INTERVAL_MS TOOL_READY_TIMEOUT_MS MCP_HTTP_PORT MCP_HTTP_HOST MCP_OAUTH
Claude Code 
claude mcp add --env LOG_LEVEL= --env LOG_STDERR_LEVEL= --env WHATSAPP_HEADLESS= --env BROWSER_EXECUTABLE_PATH= --env WHATSAPP_SESSION_DIR= --env WHATSAPP_PAIRING_PHONE_NUMBER= --env FFMPEG_PATH= --env WA_WEB_VERSION= --env HEALTH_CHECK_INTERVAL_MS= --env TOOL_READY_TIMEOUT_MS= --env MCP_HTTP_PORT= --env MCP_HTTP_HOST= --env MCP_OAUTH= mcp-whatsapp-web -- npx mcp-whatsapp-web
Cursor

Add to Cursor

If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.

VS Code 
code --add-mcp '{"name":"mcp-whatsapp-web","command":"npx","args":["mcp-whatsapp-web"],"env":{"LOG_LEVEL":"","LOG_STDERR_LEVEL":"","WHATSAPP_HEADLESS":"","BROWSER_EXECUTABLE_PATH":"","WHATSAPP_SESSION_DIR":"","WHATSAPP_PAIRING_PHONE_NUMBER":"","FFMPEG_PATH":"","WA_WEB_VERSION":"","HEALTH_CHECK_INTERVAL_MS":"","TOOL_READY_TIMEOUT_MS":"","MCP_HTTP_PORT":"","MCP_HTTP_HOST":"","MCP_OAUTH":""}}'
JSON 
{
  "mcpServers": {
    "mcp-whatsapp-web": {
      "command": "npx",
      "args": [
        "mcp-whatsapp-web"
      ],
      "env": {
        "LOG_LEVEL": "",
        "LOG_STDERR_LEVEL": "",
        "WHATSAPP_HEADLESS": "",
        "BROWSER_EXECUTABLE_PATH": "",
        "WHATSAPP_SESSION_DIR": "",
        "WHATSAPP_PAIRING_PHONE_NUMBER": "",
        "FFMPEG_PATH": "",
        "WA_WEB_VERSION": "",
        "HEALTH_CHECK_INTERVAL_MS": "",
        "TOOL_READY_TIMEOUT_MS": "",
        "MCP_HTTP_PORT": "",
        "MCP_HTTP_HOST": "",
        "MCP_OAUTH": ""
      }
    }
  }
}

Environment variables are listed by name only — fill in your own values. Entries never carry secrets.