WhatsApp Web MCP Server
io.github.mario-andreschak/mcp-whatsapp-web · Status: active
If you find your own account name here: write informally to German.saas@web.de, stating the identifier concerned. No reason has to be given. How to object
- Registry name
io.github.mario-andreschak/mcp-whatsapp-web- Package coordinate
npm:mcp-whatsapp-web- Version
1.1.0- Listed in the registry
- 2026-07-05
- Changed in the registry
- 2026-07-05
- First seen by tracevero
- 2026-08-06
- Vendor's website
- https://github.com/mario-andreschak/mcp-whatsapp-web
MCP server for WhatsApp via whatsapp-web.js: send/receive messages, media, chats, groups, contacts
Vendor's own description, untranslated and unverified
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
| Credentials required | no Raw declaration – Required secret variables (raw): confirmed absent Raw declaration – Required secret headers (raw): confirmed absent Source: MCP-Register · collected on 2026-08-06 · derived |
|---|---|
| Execution location | local Raw declaration – Transports (raw): stdio Source: MCP-Register · collected on 2026-08-06 · derived |
| Path argument present | yes Raw declaration – Path arguments (raw): confirmed absent Raw declaration – Path environment variables (raw): BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR Source: MCP-Register · collected on 2026-08-16 · derived |
| Repository URL listed | yes Raw declaration – Repository (raw): https://github.com/mario-andreschak/mcp-whatsapp-web Source: MCP-Register · collected on 2026-08-06 · derived |
| Version | 1.1.0 Source: MCP-Register · collected on 2026-08-06 · self-declared |
Position within the holdings
How many of the 24,507 published entries carry the same measured value. A reference figure, not an assessment.
- Credentials requiredno20,303 of 24,507 carry this value (83 %)View these entries
- Execution locationlocal12,078 of 24,507 carry this value (49 %)View these entries
- Path argument presentyes229 of 24,507 carry this value (0.9 %)View these entries
- Repository URL listedyes19,097 of 24,507 carry this value (78 %)View these entries
All 4 values together are carried by 187 of 24,507 entries.
This entry appears in these selections
- MCP servers without credentials20,303
- Locally executed MCP servers12,078
- MCP servers with a repository URL19,097
- MCP servers with a path argument229
- Local MCP servers without credentials9,218
- Local MCP servers with a repository URL11,472
- MCP servers over stdio only9,833
- MCP servers as an npm package only7,134
- Local MCP servers as an npm package only7,046
- npm packages with a repository URL6,786
- MCP servers over stdio, as an npm package only6,190
- MCP servers available as a package only10,633
- MCP servers with npx as their only runtime hint1,075
The source's raw values23
Evidence for this page: The values on this page come from several collections. Each row therefore states its own origin.
| Environment 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 Source: MCP-Register · collected on 2026-08-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) | BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR Source: MCP-Register · collected on 2026-08-16 · 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-07-05 Source: MCP-Register · collected on 2026-08-16 · self-declared |
| Last changed in the registry (raw) | 2026-07-05 Source: MCP-Register · collected on 2026-08-16 · 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) | paket 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.1.0 Source: MCP-Register · collected on 2026-08-16 · 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) | 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) Source: MCP-Register · collected on 2026-08-16 · self-declared |
| Icon formats (raw) | image/png Source: MCP-Register · collected on 2026-08-16 · self-declared |
Changes
| 2026-08-16 | Path argument present: false → true |
|---|---|
| 2026-08-16 | Last changed in the registry (raw): – → 2026-07-05 |
| 2026-08-16 | First listed in the registry (raw): – → 2026-07-05 |
| 2026-08-16 | Registry status message (raw): – → – |
| 2026-08-16 | Schema version of the raw record (raw): – → https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json |
| 2026-08-16 | Icon formats (raw): – → image/png |
| 2026-08-16 | Environment 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-16 | Environment variable formats (raw): – → boolean, filepath, number, string |
| 2026-08-16 | Delivery form (raw): – → paket |
| 2026-08-16 | Remote hosts (raw): – → – |
These are the 10 most recent changes to this entry. Full history
tracevero · https://tracevero.com/mcp/io-github-mario-andreschak-mcp-whatsapp-web