Skip to content

History of WhatsApp Web MCP Server

io.github.mario-andreschak/mcp-whatsapp-web · Registry status: active

Report data on this entry

Every published change to this entry, most recent first.

Changes
2026-09-08Connection paths (source structure): – → {"packages":[{"registryType":"npm","identifier":"mcp-whatsapp-web","version":"1.2.0","runtimeHint":"npx","transport":"stdio","environment":[{"name":"WHATSAPP_BACKEND","description":"WhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing","format":"string","required":false,"secret":false},{"name":"BAILEYS_SESSION_DIR","description":"Baileys credentials and synchronized history directory (default: <working directory>/baileys-sessions). Use a private absolute path, owned by one server process.","format":"filepath","required":false,"secret":false},{"name":"LOG_LEVEL","description":"Log level for the log file (logs/mcp-whatsapp.log)","format":"string","required":false,"secret":false},{"name":"LOG_STDERR_LEVEL","description":"Log level for stderr (visible in most MCP client logs)","format":"string","required":false,"secret":false},{"name":"WHATSAPP_HEADLESS","description":"webjs only: set to false to show the browser window instead of running headless","format":"boolean","required":false,"secret":false},{"name":"WHATSAPP_NO_SANDBOX","description":"webjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.","format":"boolean","required":false,"secret":false},{"name":"BROWSER_EXECUTABLE_PATH","description":"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.","format":"filepath","required":false,"secret":false},{"name":"WHATSAPP_SESSION_DIR","description":"webjs only: persistent browser profile directory (default: <working directory>/whatsapp-sessions)","format":"filepath","required":false,"secret":false},{"name":"WHATSAPP_PAIRING_PHONE_NUMBER","description":"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","format":"string","required":false,"secret":false},{"name":"FFMPEG_PATH","description":"Path to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)","format":"filepath","required":false,"secret":false},{"name":"WA_WEB_VERSION","description":"webjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.","format":"string","required":false,"secret":false},{"name":"HEALTH_CHECK_INTERVAL_MS","description":"webjs only: connection health check interval in milliseconds (<=0 disables)","format":"number","required":false,"secret":false},{"name":"TOOL_READY_TIMEOUT_MS","description":"How long tool calls wait for the WhatsApp client to become ready before erroring","format":"number","required":false,"secret":false},{"name":"MCP_HTTP_PORT","description":"When set, additionally exposes the MCP endpoint at http://127.0.0.1:<port>/mcp (Streamable HTTP) from the same process","format":"number","required":false,"secret":false},{"name":"MCP_HTTP_HOST","description":"Bind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)","format":"string","required":false,"secret":false},{"name":"MCP_OAUTH","description":"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","format":"boolean","required":false,"secret":false}],"additional_arguments_declared":false}],"remotes":[]}
2026-09-06Declared version: 1.1.0 → 1.2.0
2026-09-06Description (raw): MCP server for WhatsApp via whatsapp-web.js: send/receive messages, media, chats, groups, contacts → WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts
2026-09-06Last changed in the registry (raw): 2026-07-05 → 2026-09-05
2026-09-06First listed in the registry (raw): 2026-07-05 → 2026-09-05
2026-09-06Environment variable descriptions (raw): 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. · FFMPEG_PATH=Path to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package) · HEALTH_CHECK_INTERVAL_MS=Connection health check interval in milliseconds (<=0 disables) · 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) · MCP_HTTP_HOST=Bind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account) · 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_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 · TOOL_READY_TIMEOUT_MS=How long tool calls wait for the WhatsApp client to become ready before erroring · WA_WEB_VERSION=Pin the WhatsApp Web version. Only set this if a WhatsApp-side update breaks the client. · WHATSAPP_HEADLESS=Set to false to show the browser window instead of running headless (debugging aid) · 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 · WHATSAPP_SESSION_DIR=Where the WhatsApp session (browser profile) is stored (default: <working directory>/whatsapp-sessions) → BAILEYS_SESSION_DIR=Baileys credentials and synchronized history directory (default: <working directory>/baileys-sessions). Use a private absolute path, owned by one server process. · 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. · FFMPEG_PATH=Path to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package) · HEALTH_CHECK_INTERVAL_MS=webjs only: connection health check interval in milliseconds (<=0 disables) · 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) · MCP_HTTP_HOST=Bind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account) · 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_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 · TOOL_READY_TIMEOUT_MS=How long tool calls wait for the WhatsApp client to become ready before erroring · WA_WEB_VERSION=webjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client. · WHATSAPP_BACKEND=WhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing · 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. · 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 · WHATSAPP_SESSION_DIR=webjs only: persistent browser profile directory (default: <working directory>/whatsapp-sessions)
2026-09-06Package versions (raw): 1.1.0 → 1.2.0
2026-09-06Path environment variables (raw): BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR → BAILEYS_SESSION_DIR, BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR
2026-09-06Environment variables (raw): 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 → WHATSAPP_BACKEND, BAILEYS_SESSION_DIR, LOG_LEVEL, LOG_STDERR_LEVEL, WHATSAPP_HEADLESS, WHATSAPP_NO_SANDBOX, 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
2026-08-26Field of use, derived from the vendor description: – → Messaging
2026-08-26Description (raw): – → MCP server for WhatsApp via whatsapp-web.js: send/receive messages, media, chats, groups, contacts
2026-08-16Path argument present: no → yes
2026-08-16Last changed in the registry (raw): – → 2026-07-05
2026-08-16First listed in the registry (raw): – → 2026-07-05
2026-08-16Registry status message (raw): – → –
2026-08-16Schema version of the raw record (raw): – → https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json
2026-08-16Icon formats (raw): – → image/png
2026-08-16Environment variable descriptions (raw): – → 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. · FFMPEG_PATH=Path to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package) · HEALTH_CHECK_INTERVAL_MS=Connection health check interval in milliseconds (<=0 disables) · 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) · MCP_HTTP_HOST=Bind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account) · 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_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 · TOOL_READY_TIMEOUT_MS=How long tool calls wait for the WhatsApp client to become ready before erroring · WA_WEB_VERSION=Pin the WhatsApp Web version. Only set this if a WhatsApp-side update breaks the client. · WHATSAPP_HEADLESS=Set to false to show the browser window instead of running headless (debugging aid) · 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 · WHATSAPP_SESSION_DIR=Where the WhatsApp session (browser profile) is stored (default: <working directory>/whatsapp-sessions)
2026-08-16Environment variable formats (raw): – → boolean, filepath, number, string
2026-08-16Delivery form (raw): – → package
2026-08-16Remote hosts (raw): – → –
2026-08-16Remote URLs (raw): – → –
2026-08-16Runtime hints (raw): – → npx
2026-08-16Package versions (raw): – → 1.1.0
2026-08-16Package identifiers (raw): – → mcp-whatsapp-web
2026-08-16Repository subfolder (raw): – → –
2026-08-16Repository platform (raw): – → github
2026-08-16Path environment variables (raw): – → BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR
2026-08-16Required secret headers (raw): – → –
2026-08-06Declared version: – → 1.1.0
2026-08-06Repository URL listed: – → yes
2026-08-06Path argument present: – → no
2026-08-06Execution location: – → local
2026-08-06Required secrets declared: – → no
2026-08-06Package registries (raw): – → npm
2026-08-06Repository (raw): – → https://github.com/mario-andreschak/mcp-whatsapp-web
2026-08-06Path arguments (raw): – → –
2026-08-06Transports (raw): – → stdio
2026-08-06Required secret variables (raw): – → –
2026-08-06Environment variables (raw): – → 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

tracevero · https://tracevero.com/mcp/io-github-mario-andreschak-mcp-whatsapp-web/aenderungen