Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

WhatsApp Web MCP Server

von mario-andreschakVersion 1.2.0i★ 31iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.mario-andreschak/mcp-whatsapp-web

So installierst du es

What it does

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

  • Connects Läuft auf deinem Computer
  • Account or key No key needed · 1 setting to fill in (BROWSER_EXECUTABLE_PATH)
  • Category Chat & E-Mail

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit18/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert30/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte WhatsApp Web MCP Server. Folge https://mcp.popnx.com/i/mario-andreschak-mcp-whatsapp-web.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

1 Einstellung(en) auszufüllen (BROWSER_EXECUTABLE_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server WhatsApp Web MCP Server für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "whatsapp-web": { "command": "npx", "args": [ "-y", "mcp-whatsapp-web" ], "env": { "BROWSER_EXECUTABLE_PATH": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei BROWSER_EXECUTABLE_PATH "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von WhatsApp Web MCP Server wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • BROWSER_EXECUTABLE_PATH Nur webjs: ausführbare Datei des Browsers. Chrome und Edge werden automatisch erkannt; setzen Sie diesen Wert, um einen bestimmten Browser zu verwenden. Chrome/Edge ist für das Senden von Videos und GIFs erforderlich.
      Englisches Original anzeigenwebjs 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.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  3. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  4. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "whatsapp-web": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-whatsapp-web"
          ],
          "env": {
            "BROWSER_EXECUTABLE_PATH": "your-value"
          }
        }
      }
    }
  5. Claude beenden und neu öffnen

  6. Ausprobieren

    Nutze WhatsApp Web MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es WhatsApp Web MCP Server nutzt, oder ein Werkzeug von WhatsApp Web MCP Server in der Antwort zeigt, bist du verbunden

15 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • WHATSAPP_BACKEND WhatsApp-Backend: webjs verwendet ein persistentes Browserprofil; baileys verbindet sich ohne Browser und erfordert eine separate Kopplung.
    Englisches Original anzeigenWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · Standard webjs
  • BAILEYS_SESSION_DIR Verzeichnis für Baileys-Anmeldedaten und synchronisierten Verlauf (Standard: /baileys-sessions). Verwende einen privaten absoluten Pfad, der einem einzigen Serverprozess gehört.
    Englisches Original anzeigenBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL Log-Level für die Logdatei (logs/mcp-whatsapp.log).
    Englisches Original anzeigenLog level for the log file (logs/mcp-whatsapp.log)
    · Standard info
  • LOG_STDERR_LEVEL Log-Level für stderr (in den meisten MCP-Client-Logs sichtbar).
    Englisches Original anzeigenLog level for stderr (visible in most MCP client logs)
    · Standard warn
  • WHATSAPP_HEADLESS Nur webjs: auf false setzen, um das Browserfenster anzuzeigen statt headless zu laufen
    Englisches Original anzeigenwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX Nur webjs: deaktiviert die Browser-Sandbox explizit für Container, die dies erfordern. Die Sandbox ist standardmäßig aktiviert.
    Englisches Original anzeigenwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · Standard false
  • WHATSAPP_SESSION_DIR Nur webjs: persistentes Browser-Profilverzeichnis (Standard: /whatsapp-sessions)
    Englisches Original anzeigenwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER Kopplung per Telefonnummer: Wenn gesetzt (internationales Format ohne Sonderzeichen, z. B. 4915112345678), wird beim Start ein 8-stelliger Kopplungscode in stderr ausgegeben, anstatt sich auf den QR-Code zu verlassen.
    Englisches Original anzeigenPhone 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
  • FFMPEG_PATH Pfad zu einer ffmpeg-Binärdatei (nur erforderlich, um das über das npm-Paket ffmpeg-static automatisch installierte ffmpeg zu überschreiben)
    Englisches Original anzeigenPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION Nur webjs: die WhatsApp-Web-Version fixieren, falls ein Update auf WhatsApp-Seite den Client unbrauchbar macht.
    Englisches Original anzeigenwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs only: connection health check interval in milliseconds (<=0 disables) · Standard 60000
  • TOOL_READY_TIMEOUT_MS Wie lange Tool-Aufrufe auf die Bereitschaft des WhatsApp-Clients warten, bevor ein Fehler ausgegeben wird.
    Englisches Original anzeigenHow long tool calls wait for the WhatsApp client to become ready before erroring
    · Standard 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST Bind-Adresse für den HTTP-Endpunkt (nicht öffentlich zugänglich machen; der Endpunkt steuert dein persönliches WhatsApp-Konto)
    Englisches Original anzeigenBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · Standard 127.0.0.1
  • MCP_OAUTH Aktiviert OAuth für den HTTP-Endpunkt: /mcp erfordert ein Bearer-Token, und Clients authentifizieren sich über eine Browserseite, die den WhatsApp-QR-Code bzw. das Kopplungsformular anzeigt
    Englisches Original anzeigenEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann WhatsApp Web MCP Server noch nicht verbinden

WhatsApp Web MCP Server läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die WhatsApp Web MCP Server verbinden kann

  • 1 Einstellung(en) auszufüllen (BROWSER_EXECUTABLE_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • 1 Einstellung(en) auszufüllen (BROWSER_EXECUTABLE_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • 1 Einstellung(en) auszufüllen (BROWSER_EXECUTABLE_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • 1 Einstellung(en) auszufüllen (BROWSER_EXECUTABLE_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Chat & E-Mail, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

1 Einstellung(en) auszufüllen (BROWSER_EXECUTABLE_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server WhatsApp Web MCP Server für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user whatsapp-web --env BROWSER_EXECUTABLE_PATH=your-value -- npx -y mcp-whatsapp-web 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei BROWSER_EXECUTABLE_PATH "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von WhatsApp Web MCP Server wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • BROWSER_EXECUTABLE_PATH Nur webjs: ausführbare Datei des Browsers. Chrome und Edge werden automatisch erkannt; setzen Sie diesen Wert, um einen bestimmten Browser zu verwenden. Chrome/Edge ist für das Senden von Videos und GIFs erforderlich.
      Englisches Original anzeigenwebjs 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.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  3. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  4. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user whatsapp-web --env BROWSER_EXECUTABLE_PATH=your-value -- npx -y mcp-whatsapp-web
  5. /mcp in Claude Code eingeben

    WhatsApp Web MCP Server sollte in der Liste als verbunden erscheinen

  6. Ausprobieren

    Nutze WhatsApp Web MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es WhatsApp Web MCP Server nutzt, oder ein Werkzeug von WhatsApp Web MCP Server in der Antwort zeigt, bist du verbunden

15 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • WHATSAPP_BACKEND WhatsApp-Backend: webjs verwendet ein persistentes Browserprofil; baileys verbindet sich ohne Browser und erfordert eine separate Kopplung.
    Englisches Original anzeigenWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · Standard webjs
  • BAILEYS_SESSION_DIR Verzeichnis für Baileys-Anmeldedaten und synchronisierten Verlauf (Standard: /baileys-sessions). Verwende einen privaten absoluten Pfad, der einem einzigen Serverprozess gehört.
    Englisches Original anzeigenBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL Log-Level für die Logdatei (logs/mcp-whatsapp.log).
    Englisches Original anzeigenLog level for the log file (logs/mcp-whatsapp.log)
    · Standard info
  • LOG_STDERR_LEVEL Log-Level für stderr (in den meisten MCP-Client-Logs sichtbar).
    Englisches Original anzeigenLog level for stderr (visible in most MCP client logs)
    · Standard warn
  • WHATSAPP_HEADLESS Nur webjs: auf false setzen, um das Browserfenster anzuzeigen statt headless zu laufen
    Englisches Original anzeigenwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX Nur webjs: deaktiviert die Browser-Sandbox explizit für Container, die dies erfordern. Die Sandbox ist standardmäßig aktiviert.
    Englisches Original anzeigenwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · Standard false
  • WHATSAPP_SESSION_DIR Nur webjs: persistentes Browser-Profilverzeichnis (Standard: /whatsapp-sessions)
    Englisches Original anzeigenwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER Kopplung per Telefonnummer: Wenn gesetzt (internationales Format ohne Sonderzeichen, z. B. 4915112345678), wird beim Start ein 8-stelliger Kopplungscode in stderr ausgegeben, anstatt sich auf den QR-Code zu verlassen.
    Englisches Original anzeigenPhone 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
  • FFMPEG_PATH Pfad zu einer ffmpeg-Binärdatei (nur erforderlich, um das über das npm-Paket ffmpeg-static automatisch installierte ffmpeg zu überschreiben)
    Englisches Original anzeigenPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION Nur webjs: die WhatsApp-Web-Version fixieren, falls ein Update auf WhatsApp-Seite den Client unbrauchbar macht.
    Englisches Original anzeigenwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs only: connection health check interval in milliseconds (<=0 disables) · Standard 60000
  • TOOL_READY_TIMEOUT_MS Wie lange Tool-Aufrufe auf die Bereitschaft des WhatsApp-Clients warten, bevor ein Fehler ausgegeben wird.
    Englisches Original anzeigenHow long tool calls wait for the WhatsApp client to become ready before erroring
    · Standard 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST Bind-Adresse für den HTTP-Endpunkt (nicht öffentlich zugänglich machen; der Endpunkt steuert dein persönliches WhatsApp-Konto)
    Englisches Original anzeigenBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · Standard 127.0.0.1
  • MCP_OAUTH Aktiviert OAuth für den HTTP-Endpunkt: /mcp erfordert ein Bearer-Token, und Clients authentifizieren sich über eine Browserseite, die den WhatsApp-QR-Code bzw. das Kopplungsformular anzeigt
    Englisches Original anzeigenEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

1 Einstellung(en) auszufüllen (BROWSER_EXECUTABLE_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server WhatsApp Web MCP Server für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "whatsapp-web": { "command": "npx", "args": [ "-y", "mcp-whatsapp-web" ], "env": { "BROWSER_EXECUTABLE_PATH": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei BROWSER_EXECUTABLE_PATH "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von WhatsApp Web MCP Server wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • BROWSER_EXECUTABLE_PATH Nur webjs: ausführbare Datei des Browsers. Chrome und Edge werden automatisch erkannt; setzen Sie diesen Wert, um einen bestimmten Browser zu verwenden. Chrome/Edge ist für das Senden von Videos und GIFs erforderlich.
      Englisches Original anzeigenwebjs 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.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  3. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von WhatsApp Web MCP Server ist BROWSER_EXECUTABLE_PATH leer; trag deinen Schlüssel ein und speichere

  5. KI-Chat in Cursor im Agent-Modus öffnen

  6. Ausprobieren

    Nutze WhatsApp Web MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es WhatsApp Web MCP Server nutzt, oder ein Werkzeug von WhatsApp Web MCP Server in der Antwort zeigt, bist du verbunden

15 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • WHATSAPP_BACKEND WhatsApp-Backend: webjs verwendet ein persistentes Browserprofil; baileys verbindet sich ohne Browser und erfordert eine separate Kopplung.
    Englisches Original anzeigenWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · Standard webjs
  • BAILEYS_SESSION_DIR Verzeichnis für Baileys-Anmeldedaten und synchronisierten Verlauf (Standard: /baileys-sessions). Verwende einen privaten absoluten Pfad, der einem einzigen Serverprozess gehört.
    Englisches Original anzeigenBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL Log-Level für die Logdatei (logs/mcp-whatsapp.log).
    Englisches Original anzeigenLog level for the log file (logs/mcp-whatsapp.log)
    · Standard info
  • LOG_STDERR_LEVEL Log-Level für stderr (in den meisten MCP-Client-Logs sichtbar).
    Englisches Original anzeigenLog level for stderr (visible in most MCP client logs)
    · Standard warn
  • WHATSAPP_HEADLESS Nur webjs: auf false setzen, um das Browserfenster anzuzeigen statt headless zu laufen
    Englisches Original anzeigenwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX Nur webjs: deaktiviert die Browser-Sandbox explizit für Container, die dies erfordern. Die Sandbox ist standardmäßig aktiviert.
    Englisches Original anzeigenwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · Standard false
  • WHATSAPP_SESSION_DIR Nur webjs: persistentes Browser-Profilverzeichnis (Standard: /whatsapp-sessions)
    Englisches Original anzeigenwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER Kopplung per Telefonnummer: Wenn gesetzt (internationales Format ohne Sonderzeichen, z. B. 4915112345678), wird beim Start ein 8-stelliger Kopplungscode in stderr ausgegeben, anstatt sich auf den QR-Code zu verlassen.
    Englisches Original anzeigenPhone 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
  • FFMPEG_PATH Pfad zu einer ffmpeg-Binärdatei (nur erforderlich, um das über das npm-Paket ffmpeg-static automatisch installierte ffmpeg zu überschreiben)
    Englisches Original anzeigenPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION Nur webjs: die WhatsApp-Web-Version fixieren, falls ein Update auf WhatsApp-Seite den Client unbrauchbar macht.
    Englisches Original anzeigenwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs only: connection health check interval in milliseconds (<=0 disables) · Standard 60000
  • TOOL_READY_TIMEOUT_MS Wie lange Tool-Aufrufe auf die Bereitschaft des WhatsApp-Clients warten, bevor ein Fehler ausgegeben wird.
    Englisches Original anzeigenHow long tool calls wait for the WhatsApp client to become ready before erroring
    · Standard 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST Bind-Adresse für den HTTP-Endpunkt (nicht öffentlich zugänglich machen; der Endpunkt steuert dein persönliches WhatsApp-Konto)
    Englisches Original anzeigenBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · Standard 127.0.0.1
  • MCP_OAUTH Aktiviert OAuth für den HTTP-Endpunkt: /mcp erfordert ein Bearer-Token, und Clients authentifizieren sich über eine Browserseite, die den WhatsApp-QR-Code bzw. das Kopplungsformular anzeigt
    Englisches Original anzeigenEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

1 Einstellung(en) auszufüllen (BROWSER_EXECUTABLE_PATH) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server WhatsApp Web MCP Server für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "whatsapp-web": { "type": "stdio", "command": "npx", "args": [ "-y", "mcp-whatsapp-web" ], "env": { "BROWSER_EXECUTABLE_PATH": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei BROWSER_EXECUTABLE_PATH "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von WhatsApp Web MCP Server wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • BROWSER_EXECUTABLE_PATH Nur webjs: ausführbare Datei des Browsers. Chrome und Edge werden automatisch erkannt; setzen Sie diesen Wert, um einen bestimmten Browser zu verwenden. Chrome/Edge ist für das Senden von Videos und GIFs erforderlich.
      Englisches Original anzeigenwebjs 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.

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  3. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  4. Schlüssel eintragen

    In den Einstellungen von WhatsApp Web MCP Server ist BROWSER_EXECUTABLE_PATH leer; trag deinen Schlüssel ein und speichere

  5. KI-Chat in VS Code im Agent-Modus öffnen

  6. Ausprobieren

    Nutze WhatsApp Web MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es WhatsApp Web MCP Server nutzt, oder ein Werkzeug von WhatsApp Web MCP Server in der Antwort zeigt, bist du verbunden

15 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • WHATSAPP_BACKEND WhatsApp-Backend: webjs verwendet ein persistentes Browserprofil; baileys verbindet sich ohne Browser und erfordert eine separate Kopplung.
    Englisches Original anzeigenWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · Standard webjs
  • BAILEYS_SESSION_DIR Verzeichnis für Baileys-Anmeldedaten und synchronisierten Verlauf (Standard: /baileys-sessions). Verwende einen privaten absoluten Pfad, der einem einzigen Serverprozess gehört.
    Englisches Original anzeigenBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL Log-Level für die Logdatei (logs/mcp-whatsapp.log).
    Englisches Original anzeigenLog level for the log file (logs/mcp-whatsapp.log)
    · Standard info
  • LOG_STDERR_LEVEL Log-Level für stderr (in den meisten MCP-Client-Logs sichtbar).
    Englisches Original anzeigenLog level for stderr (visible in most MCP client logs)
    · Standard warn
  • WHATSAPP_HEADLESS Nur webjs: auf false setzen, um das Browserfenster anzuzeigen statt headless zu laufen
    Englisches Original anzeigenwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX Nur webjs: deaktiviert die Browser-Sandbox explizit für Container, die dies erfordern. Die Sandbox ist standardmäßig aktiviert.
    Englisches Original anzeigenwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · Standard false
  • WHATSAPP_SESSION_DIR Nur webjs: persistentes Browser-Profilverzeichnis (Standard: /whatsapp-sessions)
    Englisches Original anzeigenwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER Kopplung per Telefonnummer: Wenn gesetzt (internationales Format ohne Sonderzeichen, z. B. 4915112345678), wird beim Start ein 8-stelliger Kopplungscode in stderr ausgegeben, anstatt sich auf den QR-Code zu verlassen.
    Englisches Original anzeigenPhone 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
  • FFMPEG_PATH Pfad zu einer ffmpeg-Binärdatei (nur erforderlich, um das über das npm-Paket ffmpeg-static automatisch installierte ffmpeg zu überschreiben)
    Englisches Original anzeigenPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION Nur webjs: die WhatsApp-Web-Version fixieren, falls ein Update auf WhatsApp-Seite den Client unbrauchbar macht.
    Englisches Original anzeigenwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs only: connection health check interval in milliseconds (<=0 disables) · Standard 60000
  • TOOL_READY_TIMEOUT_MS Wie lange Tool-Aufrufe auf die Bereitschaft des WhatsApp-Clients warten, bevor ein Fehler ausgegeben wird.
    Englisches Original anzeigenHow long tool calls wait for the WhatsApp client to become ready before erroring
    · Standard 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST Bind-Adresse für den HTTP-Endpunkt (nicht öffentlich zugänglich machen; der Endpunkt steuert dein persönliches WhatsApp-Konto)
    Englisches Original anzeigenBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · Standard 127.0.0.1
  • MCP_OAUTH Aktiviert OAuth für den HTTP-Endpunkt: /mcp erfordert ein Bearer-Token, und Clients authentifizieren sich über eine Browserseite, die den WhatsApp-QR-Code bzw. das Kopplungsformular anzeigt
    Englisches Original anzeigenEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die WhatsApp Web MCP Server nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user whatsapp-web --env BROWSER_EXECUTABLE_PATH=your-value -- npx -y mcp-whatsapp-web

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "whatsapp-web": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • WHATSAPP_BACKEND env
    WhatsApp-Backend: webjs verwendet ein persistentes Browserprofil; baileys verbindet sich ohne Browser und erfordert eine separate Kopplung.
    Englisches Original anzeigenWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
  • BAILEYS_SESSION_DIR env
    Verzeichnis für Baileys-Anmeldedaten und synchronisierten Verlauf (Standard: /baileys-sessions). Verwende einen privaten absoluten Pfad, der einem einzigen Serverprozess gehört.
    Englisches Original anzeigenBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL env
    Log-Level für die Logdatei (logs/mcp-whatsapp.log).
    Englisches Original anzeigenLog level for the log file (logs/mcp-whatsapp.log)
  • LOG_STDERR_LEVEL env
    Log-Level für stderr (in den meisten MCP-Client-Logs sichtbar).
    Englisches Original anzeigenLog level for stderr (visible in most MCP client logs)
  • WHATSAPP_HEADLESS env
    Nur webjs: auf false setzen, um das Browserfenster anzuzeigen statt headless zu laufen
    Englisches Original anzeigenwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX env
    Nur webjs: deaktiviert die Browser-Sandbox explizit für Container, die dies erfordern. Die Sandbox ist standardmäßig aktiviert.
    Englisches Original anzeigenwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
  • BROWSER_EXECUTABLE_PATH erforderlich env
    Nur webjs: ausführbare Datei des Browsers. Chrome und Edge werden automatisch erkannt; setzen Sie diesen Wert, um einen bestimmten Browser zu verwenden. Chrome/Edge ist für das Senden von Videos und GIFs erforderlich.
    Englisches Original anzeigenwebjs 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.
  • WHATSAPP_SESSION_DIR env
    Nur webjs: persistentes Browser-Profilverzeichnis (Standard: /whatsapp-sessions)
    Englisches Original anzeigenwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER env
    Kopplung per Telefonnummer: Wenn gesetzt (internationales Format ohne Sonderzeichen, z. B. 4915112345678), wird beim Start ein 8-stelliger Kopplungscode in stderr ausgegeben, anstatt sich auf den QR-Code zu verlassen.
    Englisches Original anzeigenPhone 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
  • FFMPEG_PATH env
    Pfad zu einer ffmpeg-Binärdatei (nur erforderlich, um das über das npm-Paket ffmpeg-static automatisch installierte ffmpeg zu überschreiben)
    Englisches Original anzeigenPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION env
    Nur webjs: die WhatsApp-Web-Version fixieren, falls ein Update auf WhatsApp-Seite den Client unbrauchbar macht.
    Englisches Original anzeigenwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS env
    webjs only: connection health check interval in milliseconds (<=0 disables)
  • TOOL_READY_TIMEOUT_MS env
    Wie lange Tool-Aufrufe auf die Bereitschaft des WhatsApp-Clients warten, bevor ein Fehler ausgegeben wird.
    Englisches Original anzeigenHow long tool calls wait for the WhatsApp client to become ready before erroring
  • MCP_HTTP_PORT env
    When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST env
    Bind-Adresse für den HTTP-Endpunkt (nicht öffentlich zugänglich machen; der Endpunkt steuert dein persönliches WhatsApp-Konto)
    Englisches Original anzeigenBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
  • MCP_OAUTH env
    Aktiviert OAuth für den HTTP-Endpunkt: /mcp erfordert ein Bearer-Token, und Clients authentifizieren sich über eine Browserseite, die den WhatsApp-QR-Code bzw. das Kopplungsformular anzeigt
    Englisches Original anzeigenEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
76/Wo.
Verbindung
Läuft auf deinem Computer
Neueste Versioni
1.2.0
In der Registry veröffentlichti
6. Sept. 2026
Code zuletzt geänderti
11. Nov. 2026
Entwickler
mario-andreschak
Pakete
npm: mcp-whatsapp-web
Website
github.com
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto mario-andreschak bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 8 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für mcp-whatsapp-web@1.2.0

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mario-andreschak-mcp-whatsapp-web.svg)](https://mcp.popnx.com/en/servers/mario-andreschak-mcp-whatsapp-web)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Chat & E-Maili

  • Mehr Sterne als 97 % der anderen 2018 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 24 % der anderen 2018 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 2018 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist WhatsApp Web MCP Server sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 8 Tagen geändert, und die neueste Version (1.2.0) kam vor 2 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

von anypostWeit verbreitet↓ 5432/Wo.★ 1394Aktualisiert vor 5 Tagen

Computer oder Cloud✓ vom Dienst · emailmd.dev

Kite Discord Bot Builder

Build and fix Discord bots from a chat. Kite hosts them 24/7, with no code to deploy.

von merlinfuchsWachsend★ 334 Sterne des ganzen ReposAktualisiert vor 22 Tagen

Läuft in der Cloud✓ vom Dienst · kite.onl

e2a — email for AI agents

Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

von tokencanopyWachsend★ 200 Sterne des ganzen ReposAktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · e2a.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

von infobipAm Anfang★ 36Aktualisiert vor 13 Monaten

Läuft in der Cloud✓ vom Dienst · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

von w1neAm Anfang★ 35Aktualisiert vor 23 Tagen

Läuft in der Cloud✓ vom Dienst · kernelcad.com
Im Vergleich mit ähnlichen
Dieser
WhatsApp Web MCP Server
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
Läuft woWird auf deinem Rechner installiertIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinJaNein
Basisprüfungen3/35/54/44/44/44/4
LizenzMITMITAGPL-3.0Apache-2.0MITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Very Important

Automation of Whatsapp Messages without Meta (Business-)API is against WhatsApp' Terms of Service! You take full responsibility for everything you do with this MCP-Server. It is possible that your account will be flagged/restricted.

MCP WhatsApp Web (TypeScript)

A Model Context Protocol (MCP) server for WhatsApp Web, implemented in TypeScript. This project is a TypeScript port of the original whatsapp-mcp repository.

With this MCP server, you can:

  • Search and read your personal WhatsApp messages (including media)
  • Search your contacts
  • Send messages to individuals or groups
  • Send and receive media files (images, videos, documents, audio)

Features

  • TypeScript Implementation: Fully typed codebase for better developer experience and code reliability
  • Selectable WhatsApp Backend: Uses whatsapp-web.js by default, with an optional Baileys backend that runs without a browser
  • MCP Server: Implements the Model Context Protocol for seamless integration with AI assistants
  • Media Support: Send and receive images, videos, documents, and audio messages
  • Webhooks (Baileys): signed notifications for new messages and for incoming calls, including who is calling
  • Multiple Transport Options: Supports stdio and Streamable HTTP transports — even both at once from a single process (start with stdio and set MCP_HTTP_PORT to additionally expose http://127.0.0.1: /mcp, or run HTTP-only with --http)
  • Flexible Authentication: QR code (as an MCP image tool), pairing code (request_pairing_code tool, or automatically printed to stderr at startup via WHATSAPP_PAIRING_PHONE_NUMBER), and an optional OAuth flow for HTTP clients (MCP_OAUTH=true) where the browser authorization page shows the WhatsApp QR code — unlinking WhatsApp revokes tokens so clients automatically re-authenticate

Architecture

This MCP server consists of:

  1. TypeScript MCP Server: Implements the Model Context Protocol to provide standardized tools for AI assistants to interact with WhatsApp
  2. WhatsApp Backend: A shared service interface selects web.js/Puppeteer or Baileys/WebSocket, handles authentication, and manages message sending/receiving
  3. Tool Implementations: Provides various tools for contacts, chats, messages, media, and authentication

Prerequisites

  • Node.js >= 22.0.0 (Node 22 or 24 recommended for the Baileys SQLite dependency)
  • npm or yarn
  • For the default webjs backend: Google Chrome or Microsoft Edge (auto-detected; needed for video/GIF codec support; other operations can use Puppeteer's bundled Chromium)
  • For baileys: install optional dependencies, including the native better-sqlite3 module. No Chrome, Edge, or Chromium is needed at runtime.

FFmpeg is bundled automatically via the ffmpeg-static npm package — no manual installation needed. You can point the FFMPEG_PATH environment variable at your own binary to override it.

Installation

npx
   npx mcp-whatsapp-web
Manual Installation
  1. Clone this repository
   git clone https://github.com/mario-andreschak/mcp-whatsapp-web.git

cd mcp-whatsapp-web

  1. Install dependencies
   npm install
  1. Build the project
   npm run build
  1. Configure environment variables (optional)

Copy the example environment file and modify as needed:

   cp .env.example .env

You can select the backend with WHATSAPP_BACKEND, adjust logging levels, pin the WhatsApp Web version, or override the auto-detected browser (BROWSER_EXECUTABLE_PATH) and ffmpeg binary (FFMPEG_PATH). WHATSAPP_HEADLESS=false shows the web.js browser window, and WHATSAPP_SESSION_DIR relocates its persistent profile. Without these settings the sign-in is kept in a fixed place for your user account, so it no longer matters which folder a program starts the server from (see Keeping the link).

Choosing a backend

WHATSAPP_BACKEND=webjs is the default and preserves existing sessions and MCP tool names. It uses a dedicated persistent LocalAuth profile, not your personal Chrome profile. It now keeps the browser's native user agent and graphics defaults, omits Puppeteer's automation banner flag, and leaves the browser sandbox enabled. Containers that require disabling the sandbox can explicitly set WHATSAPP_NO_SANDBOX=true. These settings do not guarantee that automation is undetectable.

To use the optional Baileys backend, set these variables in your MCP client configuration or .env, then restart the server:

WHATSAPP_BACKEND=baileys

Optional: where the sign-in lives. Leave it out to use the standard place.

#BAILEYS_SESSION_DIR=C:/path/to/your/baileys-sessions

BAILEYS_SESSION_DIR is optional; without it the sign-in lives in the standard place described in Keeping the link. Pair this backend separately with get_qr_code or request_pairing_code. The existing WHATSAPP_PAIRING_PHONE_NUMBER option also works. Baileys cannot reuse the web.js browser profile. You can switch back to webjs and resume its existing session.

Baileys links as a Chrome device (shown as "Chrome (Windows)" or "Chrome (Mac OS)" under Linked devices). WhatsApp currently ends new links that claim to be the Desktop app with status 428 ("Connection Terminated") before a QR code appears. Desktop would request the full chat history; Chrome receives recent history, and live messages are stored from then on. BAILEYS_BROWSER=Desktop restores the old behaviour. At startup the backend also looks up the current WhatsApp Web version from web.whatsapp.com, because WhatsApp refuses clients that report an outdated one; WA_WEB_VERSION pins it, and a failed lookup falls back to the version bundled with Baileys.

Baileys and SQLite are pinned optional dependencies installed by normal npm install. If your package manager omitted them, run npm install --include=optional. SQLite uses a native addon; a supported prebuilt binary or a local native build toolchain is required. To avoid downloading Chromium when installing for Baileys or an existing system browser, use:

$env:PUPPETEER_SKIP_DOWNLOAD = 'true'

npm install --include=optional npm run build

On macOS/Linux, the equivalent installation command is PUPPETEER_SKIP_DOWNLOAD=true npm install --include=optional. Selecting Baileys loads only its driver and never starts or cleans up browser processes. An unavailable backend produces an error; it never silently switches drivers or retries a send through another backend.

Baileys sessions and history
  • Credentials, Signal keys, contacts, chats and messages persist in session.sqlite inside the sign-in folder. Keep the whole folder private and out of version control. Only one running server may own a sign-in folder. Use separate folders for independent accounts.
  • Normal shutdown and lost connections keep the sign-in. Only a clear "this device was removed" from WhatsApp, or the logout tool, ends it; both revoke the OAuth access tokens. Baileys HTTP OAuth state is stored separately from web.js in oauth-store.json inside the sign-in folder.
  • get_backend_status reports the active backend, authentication, stored record counts and history synchronization state. Being connected does not mean history has finished arriving. An available history state means local data is available, not that WhatsApp supplied a complete archive.
  • Contact and history tools query the local synchronized store. Initial full-history sync is requested and can take time on large accounts. list_messages may request up to 100 additional older messages when a known chat has fewer than requested, with a bounded wait and a per-chat cooldown. Late history batches are persisted for subsequent queries. WhatsApp may still supply only part of an account's history.
  • Treat returned message IDs as opaque and use IDs from the active backend. Legacy @c.us phone-number inputs, @s.whatsapp.net, groups and @lid identifiers are supported; known LID/phone mappings are persisted. Message IDs from web.js cannot be passed to Baileys or vice versa.
  • Text, media, downloads, voice notes and the existing authentication tools use the same MCP interface. Voice-note inputs must be local files or base64; FFmpeg converts them to mono Opus/Ogg before sending. If conversion fails, the tool reports an error without sending a different message type.

The Baileys backend is opt-in and pinned to 7.0.0-rc14. Review upstream changes before upgrading, especially authentication and message-format migrations. See the Baileys documentation and release history.

Keeping the link

You should only need to scan the QR code once. After that the server stays linked, even when it is restarted, started by a different program, or loses its internet connection for a while.

Where the sign-in lives. By default the sign-in is kept in one fixed place for your user account, whatever folder a program starts the server from:

SystemBaileysweb.js
Windows%LOCALAPPDATA%\mcp-whatsapp-web\baileys-sessions%LOCALAPPDATA%\mcp-whatsapp-web\whatsapp-sessions
macOS~/Library/Application Support/mcp-whatsapp-web/baileys-sessions~/Library/Application Support/mcp-whatsapp-web/whatsapp-sessions
Linux~/.local/share/mcp-whatsapp-web/baileys-sessions (or under $XDG_DATA_HOME)~/.local/share/mcp-whatsapp-web/whatsapp-sessions
  • If you set BAILEYS_SESSION_DIR (or WHATSAPP_SESSION_DIR for web.js), that folder is always used.
  • Older versions kept the sign-in in a baileys-sessions (or whatsapp-sessions) folder inside the folder the server was started from. If such a sign-in exists and no folder is set, the server keeps using it and says so in its log.
  • At start the log says which folder is used and whether it holds a sign-in. get_backend_status shows it too, as connection.signInFolder.

Moving the sign-in. Stop every program that runs the server, move the whole folder (all files in it) to the new place, then either put it in the standard place above or point BAILEYS_SESSION_DIR at it, and start the server again.

Using it from more than one program. Two programs cannot share one sign-in at the same time. The second one waits and takes over by itself when the first one closes. If both should run at the same time, give the second program its own folder (BAILEYS_SESSION_DIR) and link it as its own device by scanning a new QR code. WhatsApp allows several linked devices per phone. Never copy a sign-in folder to a second program: the two copies would keep pushing each other off.

When the connection drops. The server reconnects by itself: quickly at first, then every five minutes for as long as it runs, so it recovers on its own when the network comes back. Asking for WhatsApp (for example check_auth_status or any tool) makes it try again at once. get_backend_status tells you in plain words what is going on: connection.state is linked, reconnecting, waiting_for_link, waiting_for_other_program or stopped, with since, lastReason and the next attempt.

What really ends a link. Only these need a new QR code:

  • The device was removed under Settings > Linked devices on the phone, or with the logout tool.
  • The phone was offline for a long time (WhatsApp ends linked devices after about 14 days without the phone).
  • WhatsApp itself ends the link, for examp

Nur der Anfang wird gezeigt; den Rest findest du im Repo