---
bezeichner: "io.github.mario-andreschak/mcp-whatsapp-web"
art: "mcp_server"
slug: "io-github-mario-andreschak-mcp-whatsapp-web"
paketkoordinate: "npm:mcp-whatsapp-web"
status: "aktiv"
homepage: "https://github.com/mario-andreschak/mcp-whatsapp-web"
erhebungsstand: "2026-10-10T01:17:01.464Z"
namensraum: "io.github.mario-andreschak"
registerseite: "https://tracevero.de/mcp/io-github-mario-andreschak-mcp-whatsapp-web"
abgerufen_am: "2026-10-10"
zugangsdaten_erforderlich: false
ausfuehrungsort: "lokal"
dateisystem_pfadargument: true
quelloffen_einsehbar: true
einsatzgebiet: "kurznachricht"
roh_beschreibung: "WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts"
version: "1.2.0"
roh_umgebungsvariablen: "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"
roh_geheime_pflichtvariablen: ""
roh_transportarten: "stdio"
roh_pfadargumente: ""
roh_repository_url: "https://github.com/mario-andreschak/mcp-whatsapp-web"
roh_paketquellen: "npm"
roh_geheime_pflichtkopfzeilen: ""
roh_pfad_umgebungsvariablen: "BAILEYS_SESSION_DIR, BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR"
roh_remote_adressen: ""
roh_remote_hosts: ""
roh_statusmeldung: ""
roh_veroeffentlicht_am: "2026-09-05"
roh_aktualisiert_am: "2026-09-05"
roh_schemafassung: "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json"
roh_bereitstellungsform: "paket"
roh_repository_quelle: "github"
roh_repository_unterordner: ""
roh_paketbezeichner: "mcp-whatsapp-web"
roh_paketversionen: "1.2.0"
roh_laufzeithinweise: "npx"
roh_umgebungsformate: "boolean, filepath, number, string"
roh_umgebungsbeschreibungen: "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)"
roh_symbolformate: "image/png"
roh_verbindungswege: "{\"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\":[]}"
---

# WhatsApp Web MCP Server

## Gemessene Werte

| Merkmal | Wert | Quelle | Erhoben am | Vertrauensgrad | Rohangabe |
| --- | --- | --- | --- | --- | --- |
| Pflicht-Geheimnisse deklariert | false | MCP-Register | 2026-08-06T13:57:41.838Z | abgeleitet | roh_geheime_pflichtvariablen: ; roh_geheime_pflichtkopfzeilen: |
| Ausführungsort | lokal | MCP-Register | 2026-08-06T13:57:41.838Z | abgeleitet | roh_transportarten: stdio |
| Pfadargument vorhanden | true | MCP-Register | 2026-08-16T01:17:01.420Z | abgeleitet | roh_pfadargumente: ; roh_pfad_umgebungsvariablen: BAILEYS_SESSION_DIR, BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR |
| Repository-Adresse geführt | true | MCP-Register | 2026-08-06T13:57:41.838Z | abgeleitet | roh_repository_url: https://github.com/mario-andreschak/mcp-whatsapp-web |
| Einsatzgebiet, aus der Anbieterbeschreibung abgeleitet | kurznachricht | MCP-Register | 2026-08-26T16:45:01.514Z | abgeleitet | roh_beschreibung: WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts |
| Beschreibung (Rohangabe) | WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts | MCP-Register | 2026-09-06T01:17:02.381Z | selbstauskunft |  |
| Deklarierte Version | 1.2.0 | MCP-Register | 2026-09-06T01:17:02.381Z | selbstauskunft |  |
| Umgebungsvariablen (Rohangabe) | 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 | MCP-Register | 2026-09-06T01:17:02.381Z | selbstauskunft |  |
| Geheime Pflichtvariablen (Rohangabe) |  | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft |  |
| Transportarten (Rohangabe) | stdio | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft |  |
| Pfadargumente (Rohangabe) |  | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft |  |
| Repository (Rohangabe) | https://github.com/mario-andreschak/mcp-whatsapp-web | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft |  |
| Paketquellen (Rohangabe) | npm | MCP-Register | 2026-08-06T13:57:41.838Z | selbstauskunft |  |
| Geheime Pflichtkopfzeilen (Rohangabe) |  | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Pfad-Umgebungsvariablen (Rohangabe) | BAILEYS_SESSION_DIR, BROWSER_EXECUTABLE_PATH, FFMPEG_PATH, WHATSAPP_SESSION_DIR | MCP-Register | 2026-09-06T01:17:02.381Z | selbstauskunft |  |
| Remote-Adressen (Rohangabe) |  | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Remote-Hosts (Rohangabe) |  | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Statusmeldung des Registers (Rohangabe) |  | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Im Register eingetragen am (Rohangabe) | 2026-09-05 | MCP-Register | 2026-09-06T01:17:02.381Z | selbstauskunft |  |
| Im Register geändert am (Rohangabe) | 2026-09-05 | MCP-Register | 2026-09-06T01:17:02.381Z | selbstauskunft |  |
| Schemafassung des Rohsatzes (Rohangabe) | https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Bereitstellungsform (Rohangabe) | paket | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Repository-Plattform (Rohangabe) | github | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Repository-Unterordner (Rohangabe) |  | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Paketbezeichner (Rohangabe) | mcp-whatsapp-web | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Paketversionen (Rohangabe) | 1.2.0 | MCP-Register | 2026-09-06T01:17:02.381Z | selbstauskunft |  |
| Laufzeithinweise (Rohangabe) | npx | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Formate der Umgebungsvariablen (Rohangabe) | boolean, filepath, number, string | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Beschreibungen der Umgebungsvariablen (Rohangabe) | 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) | MCP-Register | 2026-09-06T01:17:02.381Z | selbstauskunft |  |
| Symbolformate (Rohangabe) | image/png | MCP-Register | 2026-08-16T01:17:01.420Z | selbstauskunft |  |
| Verbindungswege (Quellstruktur) | {"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":[]} | MCP-Register | 2026-09-08T01:17:01.649Z | selbstauskunft |  |

## Verweise

- Namensraum: [[namensraum/io-github-mario-andreschak|io.github.mario-andreschak]]

---

- Registerseite: <https://tracevero.de/mcp/io-github-mario-andreschak-mcp-whatsapp-web>
- Abgerufen am: 2026-10-10
