Skip to content

WhatsApp Web MCP Server

Local package path declaredNo credentials listedRepository declared by sourceUpdated 2026-09-05

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

Report data on this entry

At a glance

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

Vendor's own description, untranslated and unverified

Execution location
Local package path declaredMCP-Register · 2026-08-06
Required secrets declared
No credentials listedMCP-Register · 2026-08-06
Declared version and change
1.2.0 · Source-reported change date 2026-09-05MCP-Register · 2026-09-06
Repository as declared
github.com/mario-andreschak/mcp-whatsapp-webMCP-Register · 2026-08-06
Configuration
can be built from the disclosed start template

Inspect connection paths and prerequisites

Related categories

6 of 14 categories. All categories in the segment catalogue

Page last changed:

Sources and collection
Runs
Local package path declared
Credentials
No credentials listed
Registry record changed
2026-09-05
Setup
Template available
Registry name
io.github.mario-andreschak/mcp-whatsapp-web
Package coordinate
npm:mcp-whatsapp-web
Declared version
1.2.0
Source-reported listing date
2026-09-05
Source-reported change date
2026-09-05
First seen by tracevero
2026-08-06
Vendor's website
https://github.com/mario-andreschak/mcp-whatsapp-web

Evidence for this page: The values on this page come from several collections. Each row therefore states its own origin. What the confidence levels mean

Measured values

Measured values
Required secrets declaredNo credentials listed no
Original data – Required secret variables (raw): confirmed absent
Original data – Required secret headers (raw): confirmed absent
Source: MCP-Register · collected on 2026-08-06 · derived
Execution locationLocal package path declared local
Original data – Transports (raw): stdio
Source: MCP-Register · collected on 2026-08-06 · derived
Path argument presentyes
Original data – Path arguments (raw): confirmed absent
Original data – Path environment variables (raw): BAILEYS_SESSION_DIR, BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR
Source: MCP-Register · collected on 2026-08-16 · derived
Repository URL listedRepository declared by source yes
Original data – Repository (raw): https://github.com/mario-andreschak/mcp-whatsapp-web
Source: MCP-Register · collected on 2026-08-06 · derived
Field of use, derived from the vendor descriptionMessaging
Original data – Description (raw): WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts
Source: MCP-Register · collected on 2026-08-26 · derived
Declared version1.2.0
Source: MCP-Register · collected on 2026-09-06 · self-declared

What is measured is what a manifest declares, not what a piece of software does. This registry fetches no repository URL, no endpoint and no package index; nothing here is verified. Which value comes from which source, and by which rule it was formed, is set out in the Methodology.

Source data25

Evidence for this page: The values on this page come from several collections. Each row therefore states its own origin.

Raw values
Description (raw)WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts
Source: MCP-Register · collected on 2026-09-06 · self-declared
Environment variables (raw)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
Source: MCP-Register · collected on 2026-09-06 · self-declared
Required secret variables (raw)confirmed absent
Source: MCP-Register · collected on 2026-08-06 · self-declared
Transports (raw)stdio
Source: MCP-Register · collected on 2026-08-06 · self-declared
Path arguments (raw)confirmed absent
Source: MCP-Register · collected on 2026-08-06 · self-declared
Repository (raw)https://github.com/mario-andreschak/mcp-whatsapp-web
Source: MCP-Register · collected on 2026-08-06 · self-declared
Package registries (raw)npm
Source: MCP-Register · collected on 2026-08-06 · self-declared
Required secret headers (raw)confirmed absent
Source: MCP-Register · collected on 2026-08-16 · self-declared
Path environment variables (raw)BAILEYS_SESSION_DIR, BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR
Source: MCP-Register · collected on 2026-09-06 · self-declared
Remote URLs (raw)confirmed absent
Source: MCP-Register · collected on 2026-08-16 · self-declared
Remote hosts (raw)confirmed absent
Source: MCP-Register · collected on 2026-08-16 · self-declared
Registry status message (raw)confirmed absent
Source: MCP-Register · collected on 2026-08-16 · self-declared
First listed in the registry (raw)2026-09-05
Source: MCP-Register · collected on 2026-09-06 · self-declared
Last changed in the registry (raw)2026-09-05
Source: MCP-Register · collected on 2026-09-06 · self-declared
Schema version of the raw record (raw)https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json
Source: MCP-Register · collected on 2026-08-16 · self-declared
Delivery form (raw)package
Source: MCP-Register · collected on 2026-08-16 · self-declared
Repository platform (raw)github
Source: MCP-Register · collected on 2026-08-16 · self-declared
Repository subfolder (raw)confirmed absent
Source: MCP-Register · collected on 2026-08-16 · self-declared
Package identifiers (raw)mcp-whatsapp-web
Source: MCP-Register · collected on 2026-08-16 · self-declared
Package versions (raw)1.2.0
Source: MCP-Register · collected on 2026-09-06 · self-declared
Runtime hints (raw)npx
Source: MCP-Register · collected on 2026-08-16 · self-declared
Environment variable formats (raw)boolean, filepath, number, string
Source: MCP-Register · collected on 2026-08-16 · self-declared
Environment variable descriptions (raw)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)
Source: MCP-Register · collected on 2026-09-06 · self-declared
Icon formats (raw)image/png
Source: MCP-Register · collected on 2026-08-16 · self-declared
Connection 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":[]}
Source: MCP-Register · collected on 2026-09-08 · self-declared
Embed this badge

Paste this line into a README of your own. The badge states how many values the registry holds for the entry and when it last looked, and it links back to this page.

tracevero: number of measured values and date of collection for this registry entry

[![tracevero: number of measured values and date of collection for this registry entry](https://tracevero.com/badge/mcp/io-github-mario-andreschak-mcp-whatsapp-web.svg)](https://tracevero.com/mcp/io-github-mario-andreschak-mcp-whatsapp-web)

The image is drawn again on every request, so it always reports the current state while the pasted line stays as it is. It carries no rating and no traffic light – only the two measured figures.

Changes

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

These are the 3 most recent changes to this entry. Full history

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