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 Anmelden

Evolution WhatsApp

von EwertonslvVersion 0.3.1i★ 0iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.Ewertonslv/evolution-whatsapp-mcp

So installierst du es

Was es kann

Send and read WhatsApp messages, send media and manage instances via the Evolution API.

Originaltext des Herstellers

  • Verbindung Läuft auf deinem Computer
  • Konto oder Schlüssel Braucht EVOLUTION_API_KEY · 1 Einstellung auszufüllen (EVOLUTION_API_URL)
  • Kategorie Chat & E-Mail

Warum es hier steht

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

Beliebtheit0/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
Nutzungswert12/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 Evolution WhatsApp. Folge https://mcp.popnx.com/i/ewertonslv-evolution-whatsapp-mcp.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

Du brauchst einen Schlüssel von Evolution WhatsApp (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (EVOLUTION_API_URL) · 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 Evolution WhatsApp 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": { "evolution-whatsapp": { "command": "npx", "args": [ "-y", "evolution-whatsapp-mcp" ], "env": { "EVOLUTION_API_URL": "your-value", "EVOLUTION_API_KEY": "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 EVOLUTION_API_KEY, EVOLUTION_API_URL "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 Evolution WhatsApp 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. Bei Evolution WhatsApp registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Evolution WhatsApp öffnen ↗

  3. 1 Einstellung(en) ausfüllen

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

    • EVOLUTION_API_URL URL deines Evolution-API-Servers, z. B. http://localhost:8080. Außerhalb von localhost https verwenden.
      Englisches Original anzeigenBase URL of your Evolution API server, e.g. http://localhost:8080. Use https outside localhost.

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

  4. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  5. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "evolution-whatsapp": {
          "command": "npx",
          "args": [
            "-y",
            "evolution-whatsapp-mcp"
          ],
          "env": {
            "EVOLUTION_API_URL": "your-value",
            "EVOLUTION_API_KEY": "your-value"
          }
        }
      }
    }

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. Claude beenden und neu öffnen

  7. Ausprobieren

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

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

5 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.

  • EVOLUTION_DEFAULT_INSTANCE Standardinstanz, die verwendet wird, wenn ein Tool-Aufruf das instance-Argument weglässt
    Englisches Original anzeigenDefault instance used when a tool call omits the instance argument.
  • EVOLUTION_TIMEOUT_MS Timeout pro Anfrage in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request timeout in milliseconds (default 30000).
  • EVOLUTION_READ_ONLY Auf true setzen, um alle Werkzeuge auszublenden, die etwas senden oder den Zustand ändern (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
    Englisches Original anzeigenSet to true to hide every tool that sends or changes state (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
  • EVOLUTION_CONFIRM_WRITES Auf true setzen, um vor der Ausführung von send_text, send_media, create_instance, disconnect_instance oder configure_webhook eine menschliche Bestätigung (Dialogfenster) zu verlangen. Clients, die kein Dialogfenster anzeigen können, werden abgelehnt.
    Englisches Original anzeigenSet to true to require a human confirmation (elicitation dialog) before send_text, send_media, create_instance, disconnect_instance or configure_webhook run. Clients that can show no dialog are refus…
    · Standard false
  • EVOLUTION_ALLOWED_NUMBERS Durch Kommas getrennte Telefonnummern, an die send_text und send_media senden dürfen. Leer bedeutet keine Einschränkung
    Englisches Original anzeigenComma-separated phone numbers that send_text and send_media may reach. Empty means no restriction.

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 Evolution WhatsApp noch nicht verbinden

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

Das kannst du stattdessen tun

A · Eine App nutzen, die Evolution WhatsApp verbinden kann

  • Du brauchst einen Schlüssel von Evolution WhatsApp (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (EVOLUTION_API_URL) · 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
  • Du brauchst einen Schlüssel von Evolution WhatsApp (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (EVOLUTION_API_URL) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Evolution WhatsApp (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (EVOLUTION_API_URL) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Evolution WhatsApp (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (EVOLUTION_API_URL) · 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

Du brauchst einen Schlüssel von Evolution WhatsApp (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (EVOLUTION_API_URL) · 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 Evolution WhatsApp 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 evolution-whatsapp --env EVOLUTION_API_URL=your-value --env EVOLUTION_API_KEY=your-value -- npx -y evolution-whatsapp-mcp 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 EVOLUTION_API_KEY, EVOLUTION_API_URL "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 Evolution WhatsApp 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. Bei Evolution WhatsApp registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Evolution WhatsApp öffnen ↗

  3. 1 Einstellung(en) ausfüllen

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

    • EVOLUTION_API_URL URL deines Evolution-API-Servers, z. B. http://localhost:8080. Außerhalb von localhost https verwenden.
      Englisches Original anzeigenBase URL of your Evolution API server, e.g. http://localhost:8080. Use https outside localhost.

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

  4. Terminal öffnen

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

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

    claude mcp add --scope user evolution-whatsapp --env EVOLUTION_API_URL=your-value --env EVOLUTION_API_KEY=your-value -- npx -y evolution-whatsapp-mcp

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. /mcp in Claude Code eingeben

    Evolution WhatsApp sollte in der Liste als verbunden erscheinen

  7. Ausprobieren

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

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

5 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.

  • EVOLUTION_DEFAULT_INSTANCE Standardinstanz, die verwendet wird, wenn ein Tool-Aufruf das instance-Argument weglässt
    Englisches Original anzeigenDefault instance used when a tool call omits the instance argument.
  • EVOLUTION_TIMEOUT_MS Timeout pro Anfrage in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request timeout in milliseconds (default 30000).
  • EVOLUTION_READ_ONLY Auf true setzen, um alle Werkzeuge auszublenden, die etwas senden oder den Zustand ändern (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
    Englisches Original anzeigenSet to true to hide every tool that sends or changes state (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
  • EVOLUTION_CONFIRM_WRITES Auf true setzen, um vor der Ausführung von send_text, send_media, create_instance, disconnect_instance oder configure_webhook eine menschliche Bestätigung (Dialogfenster) zu verlangen. Clients, die kein Dialogfenster anzeigen können, werden abgelehnt.
    Englisches Original anzeigenSet to true to require a human confirmation (elicitation dialog) before send_text, send_media, create_instance, disconnect_instance or configure_webhook run. Clients that can show no dialog are refus…
    · Standard false
  • EVOLUTION_ALLOWED_NUMBERS Durch Kommas getrennte Telefonnummern, an die send_text und send_media senden dürfen. Leer bedeutet keine Einschränkung
    Englisches Original anzeigenComma-separated phone numbers that send_text and send_media may reach. Empty means no restriction.

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

Du brauchst einen Schlüssel von Evolution WhatsApp (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (EVOLUTION_API_URL) · 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 Evolution WhatsApp 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": { "evolution-whatsapp": { "command": "npx", "args": [ "-y", "evolution-whatsapp-mcp" ], "env": { "EVOLUTION_API_URL": "your-value", "EVOLUTION_API_KEY": "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 EVOLUTION_API_KEY, EVOLUTION_API_URL "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 Evolution WhatsApp 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. Bei Evolution WhatsApp registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Evolution WhatsApp öffnen ↗

  3. 1 Einstellung(en) ausfüllen

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

    • EVOLUTION_API_URL URL deines Evolution-API-Servers, z. B. http://localhost:8080. Außerhalb von localhost https verwenden.
      Englisches Original anzeigenBase URL of your Evolution API server, e.g. http://localhost:8080. Use https outside localhost.

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

  4. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von Evolution WhatsApp ist EVOLUTION_API_KEY, EVOLUTION_API_URL leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

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

  7. Ausprobieren

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

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

5 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.

  • EVOLUTION_DEFAULT_INSTANCE Standardinstanz, die verwendet wird, wenn ein Tool-Aufruf das instance-Argument weglässt
    Englisches Original anzeigenDefault instance used when a tool call omits the instance argument.
  • EVOLUTION_TIMEOUT_MS Timeout pro Anfrage in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request timeout in milliseconds (default 30000).
  • EVOLUTION_READ_ONLY Auf true setzen, um alle Werkzeuge auszublenden, die etwas senden oder den Zustand ändern (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
    Englisches Original anzeigenSet to true to hide every tool that sends or changes state (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
  • EVOLUTION_CONFIRM_WRITES Auf true setzen, um vor der Ausführung von send_text, send_media, create_instance, disconnect_instance oder configure_webhook eine menschliche Bestätigung (Dialogfenster) zu verlangen. Clients, die kein Dialogfenster anzeigen können, werden abgelehnt.
    Englisches Original anzeigenSet to true to require a human confirmation (elicitation dialog) before send_text, send_media, create_instance, disconnect_instance or configure_webhook run. Clients that can show no dialog are refus…
    · Standard false
  • EVOLUTION_ALLOWED_NUMBERS Durch Kommas getrennte Telefonnummern, an die send_text und send_media senden dürfen. Leer bedeutet keine Einschränkung
    Englisches Original anzeigenComma-separated phone numbers that send_text and send_media may reach. Empty means no restriction.

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

Du brauchst einen Schlüssel von Evolution WhatsApp (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (EVOLUTION_API_URL) · 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 Evolution WhatsApp 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": { "evolution-whatsapp": { "type": "stdio", "command": "npx", "args": [ "-y", "evolution-whatsapp-mcp" ], "env": { "EVOLUTION_API_URL": "your-value", "EVOLUTION_API_KEY": "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 EVOLUTION_API_KEY, EVOLUTION_API_URL "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 Evolution WhatsApp 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. Bei Evolution WhatsApp registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von Evolution WhatsApp öffnen ↗

  3. 1 Einstellung(en) ausfüllen

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

    • EVOLUTION_API_URL URL deines Evolution-API-Servers, z. B. http://localhost:8080. Außerhalb von localhost https verwenden.
      Englisches Original anzeigenBase URL of your Evolution API server, e.g. http://localhost:8080. Use https outside localhost.

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

  4. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von Evolution WhatsApp ist EVOLUTION_API_KEY, EVOLUTION_API_URL leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

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

  7. Ausprobieren

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

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

5 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.

  • EVOLUTION_DEFAULT_INSTANCE Standardinstanz, die verwendet wird, wenn ein Tool-Aufruf das instance-Argument weglässt
    Englisches Original anzeigenDefault instance used when a tool call omits the instance argument.
  • EVOLUTION_TIMEOUT_MS Timeout pro Anfrage in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request timeout in milliseconds (default 30000).
  • EVOLUTION_READ_ONLY Auf true setzen, um alle Werkzeuge auszublenden, die etwas senden oder den Zustand ändern (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
    Englisches Original anzeigenSet to true to hide every tool that sends or changes state (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
  • EVOLUTION_CONFIRM_WRITES Auf true setzen, um vor der Ausführung von send_text, send_media, create_instance, disconnect_instance oder configure_webhook eine menschliche Bestätigung (Dialogfenster) zu verlangen. Clients, die kein Dialogfenster anzeigen können, werden abgelehnt.
    Englisches Original anzeigenSet to true to require a human confirmation (elicitation dialog) before send_text, send_media, create_instance, disconnect_instance or configure_webhook run. Clients that can show no dialog are refus…
    · Standard false
  • EVOLUTION_ALLOWED_NUMBERS Durch Kommas getrennte Telefonnummern, an die send_text und send_media senden dürfen. Leer bedeutet keine Einschränkung
    Englisches Original anzeigenComma-separated phone numbers that send_text and send_media may reach. Empty means no restriction.

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 Evolution WhatsApp nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user evolution-whatsapp --env EVOLUTION_API_URL=your-value --env EVOLUTION_API_KEY=your-value -- npx -y evolution-whatsapp-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "evolution-whatsapp": {
      "command": "npx",
      "args": [
        "-y",
        "evolution-whatsapp-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "your-value",
        "EVOLUTION_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "evolution-whatsapp": {
      "command": "npx",
      "args": [
        "-y",
        "evolution-whatsapp-mcp"
      ],
      "env": {
        "EVOLUTION_API_URL": "your-value",
        "EVOLUTION_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

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

Werte, die du selbst einträgst

  • EVOLUTION_API_URL erforderlich env
    URL deines Evolution-API-Servers, z. B. http://localhost:8080. Außerhalb von localhost https verwenden.
    Englisches Original anzeigenBase URL of your Evolution API server, e.g. http://localhost:8080. Use https outside localhost.
  • EVOLUTION_API_KEY geheim erforderlich env
    Evolution-API-Schlüssel, der im Header apikey gesendet wird.
    Englisches Original anzeigenEvolution API key, sent as the apikey header.
  • EVOLUTION_DEFAULT_INSTANCE env
    Standardinstanz, die verwendet wird, wenn ein Tool-Aufruf das instance-Argument weglässt
    Englisches Original anzeigenDefault instance used when a tool call omits the instance argument.
  • EVOLUTION_TIMEOUT_MS env
    Timeout pro Anfrage in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request timeout in milliseconds (default 30000).
  • EVOLUTION_READ_ONLY env
    Auf true setzen, um alle Werkzeuge auszublenden, die etwas senden oder den Zustand ändern (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
    Englisches Original anzeigenSet to true to hide every tool that sends or changes state (send_text, send_media, create_instance, disconnect_instance, configure_webhook).
  • EVOLUTION_CONFIRM_WRITES env
    Auf true setzen, um vor der Ausführung von send_text, send_media, create_instance, disconnect_instance oder configure_webhook eine menschliche Bestätigung (Dialogfenster) zu verlangen. Clients, die kein Dialogfenster anzeigen können, werden abgelehnt.
    Englisches Original anzeigenSet to true to require a human confirmation (elicitation dialog) before send_text, send_media, create_instance, disconnect_instance or configure_webhook run. Clients that can show no dialog are refus…
  • EVOLUTION_ALLOWED_NUMBERS env
    Durch Kommas getrennte Telefonnummern, an die send_text und send_media senden dürfen. Leer bedeutet keine Einschränkung
    Englisches Original anzeigenComma-separated phone numbers that send_text and send_media may reach. Empty means no restriction.

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
28/Wo.
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.3.1
In der Registry veröffentlichti
9. Nov. 2026
Code zuletzt geänderti
9. Nov. 2026
Entwickler
Ewertonslv
Pakete
npm: evolution-whatsapp-mcp
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 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

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

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 11 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 evolution-whatsapp-mcp@0.3.1

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 16. 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/ewertonslv-evolution-whatsapp-mcp.svg)](https://mcp.popnx.com/en/servers/ewertonslv-evolution-whatsapp-mcp)

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 0 % der anderen 2038 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 74 % der anderen 2038 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 2038 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 Evolution WhatsApp 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?

Das musst du eintragen: EVOLUTION_API_KEY

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 11 Tagen geändert, und die neueste Version (0.3.1) kam vor 11 Tagen 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.★ 1395Aktualisiert vor 6 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 23 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 24 Tagen

Läuft in der Cloud✓ vom Dienst · kernelcad.com
Im Vergleich mit ähnlichen
Dieser
Evolution WhatsApp
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üsselJaNeinNeinNeinNeinNein
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.

evolution-whatsapp-mcp

An [MCP](https://modelcontextprotocol.io) server that lets Claude (and any MCP client) use WhatsApp. It sends and reads messages, sends media, and manages connections through the Evolution API. Add it to Claude Desktop/Code and your agent can connect a WhatsApp number and talk to people.

The client code comes from the WhatsApp integration of a multi-tenant clinic SaaS. All nine tools

were last checked against a real Evolution API 2.3.7 server in October 2026.

Architecture & where it runs

Claude (Desktop/Code)        evolution-whatsapp-mcp          Evolution API        WhatsApp

[MCP client] ──stdio──► (this package) ──HTTP──► (gateway) ──────► (phone)

  • This MCP server runs locally, on demand. You don't host it. Your MCP client (Claude Desktop/Code) spawns it as a child process over stdio (npx evolution-whatsapp-mcp); it starts when the client needs it and exits when the client closes. No open ports, no deployment.
  • The Evolution API is the part that must stay running, because it holds the WhatsApp session (like WhatsApp Web: if it goes down, the number disconnects). Run it locally via Docker to try things out, or on a small VPS if you need it online 24/7 (e.g. to receive messages via webhook). This server only needs its URL + API key.
  • The server is stateless. It has no database and stores no messages. It only forwards calls from your MCP client to the Evolution API.

Tools

ToolDescription
send_textSend a text message to a phone number
send_mediaSend an image / video / document / audio (URL or base64)
find_chatsList the conversations on the instance (limit, default 50, max 200)
find_messagesRead a chat's message history (by phone or JID), with limit (default 50, max 200) and page
create_instanceCreate a new instance (a WhatsApp connection slot)
get_qrcodeGet the QR code (base64) to link a WhatsApp number
connection_statusCheck whether the instance is connected
disconnect_instanceLog the WhatsApp number out of the instance
configure_webhookPoint the instance webhook to a public URL

Every tool takes an optional instance argument; if omitted it falls back to EVOLUTION_DEFAULT_INSTANCE.

Tools carry MCP annotations: the read tools are marked read-only, and disconnect_instance and configure_webhook are marked destructive so clients can ask for confirmation first.

find_messages accepts a Brazilian number with or without the ninth digit. WhatsApp stores some chats under the short form, so the tool tries the other form when the first one has no messages.

Prerequisites

A running Evolution API server (v2.x) and its API key. The quickest way to run one locally is the example docker-compose.yml (Evolution API v2 with the Postgres and Redis it needs). Use local Docker to try it out, or a VPS for 24/7 operation:

EVOLUTION_API_KEY=my-secret-key docker compose up -d

It listens on http://localhost:8080. Use the same value for EVOLUTION_API_KEY when you plug in the MCP server (see above). The compose file is a starting point, not a production setup.

Install & configure

One line for Claude Code:

claude mcp add evolution-whatsapp \

-e EVOLUTION_API_URL=http://localhost:8080 \ -e EVOLUTION_API_KEY=your-evolution-api-key \ -- npx -y evolution-whatsapp-mcp

For other clients, add it to the MCP client config. For Claude Desktop / Claude Code (mcpServers config):

{

"mcpServers": { "whatsapp": { "command": "npx", "args": ["-y", "evolution-whatsapp-mcp"], "env": { "EVOLUTION_API_URL": "http://localhost:8080", "EVOLUTION_API_KEY": "your-evolution-api-key", "EVOLUTION_DEFAULT_INSTANCE": "my-whatsapp" } } } }

Env varRequiredDescription
EVOLUTION_API_URLyesBase URL of your Evolution API server
EVOLUTION_API_KEYyesEvolution API key (sent as the apikey header)
EVOLUTION_DEFAULT_INSTANCEnoDefault instance when a tool omits instance
EVOLUTION_TIMEOUT_MSnoPer-request timeout in milliseconds (default 30000)
EVOLUTION_READ_ONLYnotrue, 1 or yes (any case) hides send_text, send_media, create_instance, disconnect_instance and configure_webhook. Anything else leaves them on
EVOLUTION_CONFIRM_WRITESnotrue, 1 or yes (any case) makes send_text, send_media, create_instance, disconnect_instance and configure_webhook wait for a human to confirm. A client that can show no confirmation is refused and nothing is sent. false, 0, no or empty is off (default). Any other value (a typo such as ture or on) counts as on and prints a warning on stderr
EVOLUTION_ALLOWED_NUMBERSnoComma-separated numbers send_text and send_media may reach (e.g. 5511999999999,5521988887777). Empty means no restriction. Brazilian numbers match with or without the ninth digit; group JIDs are refused when the list is set

Because an LLM drives these tools, a prompt injected through a received message could ask it to send something. EVOLUTION_READ_ONLY and EVOLUTION_ALLOWED_NUMBERS limit what it can do.

Built-in limits: find_chats and find_messages take limit (1-200, default 50); any response over 100,000 characters is truncated with a notice; get_qrcode drops an oversized base64 image and keeps the pairing code. configure_webhook only accepts https URLs (plain http is allowed for localhost, 127.0.0.1 and [::1]). The server prints a warning on stderr if EVOLUTION_API_URL is neither https nor localhost, since the API key would travel unencrypted.

Confirm before writing

Tool descriptions are advice, not a lock: a model can still call disconnect_instance to "restart the connection". With EVOLUTION_CONFIRM_WRITES=true the server holds each write (send_text, send_media, create_instance, disconnect_instance, configure_webhook) until a person confirms it through the client, a channel the model does not control. It is off by default, so headless automation keeps working; turn it on when a person is in the loop.

What the person sees is a short preview: the action, the recipient with the number masked (+55 11 9****-9999), and up to 200 characters of the text. Media content and webhook paths or query strings are never shown. The dialog defaults to "no" and waits 120 seconds; anything other than an explicit yes (decline, cancel, timeout, error) sends nothing.

Client declaresResult
Form elicitation (elicitation, as in Claude Code)A yes/no dialog before each write
Anything else (no capabilities, URL-only elicitation, MCP Apps only)The write is refused with isError and nothing is sent

A confirmation card for MCP Apps clients is not part of this release. Claude Code does not render MCP Apps (client matrix at modelcontextprotocol/modelcontextprotocol, 2026-11-03), so it uses the dialog. Some Claude Code versions have been reported to auto-decline elicitation forms; in that case the write is refused, never sent.

It combines with the other limits: EVOLUTION_ALLOWED_NUMBERS is checked first (a number outside the list is refused without asking), and with EVOLUTION_READ_ONLY on there are no write tools to confirm.

Example flow (end to end)

Ask Claude:

  1. *"Create a WhatsApp instance called my-whatsapp and show me the QR code."* → create_instance + get_qrcode (scan it with your phone).
  2. *"Is it connected?"* → connection_status.
  3. *"Send 'Your appointment is confirmed' to +55 11 99999-9999."* → send_text.
  4. *"What did they reply?"* → find_messages.

Troubleshooting

SymptomCause and fix
HTTP 401 / UnauthorizedEVOLUTION_API_KEY does not match the server's AUTHENTICATION_API_KEY.
Timeout / fetch failedThe URL is wrong or the Evolution API is down. Open EVOLUTION_API_URL in a browser; raise EVOLUTION_TIMEOUT_MS for slow servers.
Sends fail, instance not openThe instance is not connected. Run connection_status, then get_qrcode and scan it from the phone (WhatsApp > Linked devices).
find_messages returns nothing for a Brazilian numberWhatsApp may store the chat with or without the ninth digit. The tool tries both; check the number has the country code (55).
number must be a phone with 8 to 15 digitsPass the full number with country code, or a JID containing @.
Webhook URL refusedconfigure_webhook requires https (http only for localhost, 127.0.0.1, [::1]). Look-alike hosts such as localhost.evil.com are refused.
send_text is missing from the tool listEVOLUTION_READ_ONLY is on. Unset it or set it to false.
Recipient is not in EVOLUTION_ALLOWED_NUMBERSThe number is not on the allowlist. Add it, or leave the variable empty.
Response ends with truncated: use limit/pageThe payload was over 100,000 characters. Lower limit or read page by page.

Directory listings

Metadata for the official MCP registry is in server.json and for Smithery in smithery.yaml. Glama indexes public GitHub MCP servers from this README and package.json, so keep both accurate.

Development

npm install

npm run build # tsc → dist/ npm test # vitest (mocks the Evolution API; no server needed) npm run lint # tsc --noEmit

Inspect the server locally with the MCP Inspector:

EVOLUTION_API_URL=http://localhost:8080 EVOLUTION_API_KEY=key \

npx @modelcontextprotocol/inspector node dist/index.js

How it works

A thin REST client (src/evolution.ts) wraps the Evolution endpoints and authenticates with the apikey header. src/tools.ts registers each operation as an MCP tool with a zod input schema; src/index.ts serves them over stdio.

License

MIT © Ewerton Silva