Evolution API MCP

MCP-Server zum Senden und Empfangen von WhatsApp-Nachrichten direkt aus Claude Code unter Verwendung der Evolution API (Open-Source, selbst gehostet).

Was es kann

• Erstellen und Verwalten von WhatsApp-Instanzen

• Senden von Textnachrichten, Medien, Audio, Standorten, Kontakten, Umfragen, Stickern, Schaltflächen und Listen

• Lesen von Unterhaltungen und empfangenen Nachrichten

• Reagieren auf Nachrichten, Archivieren von Chats, Markieren als gelesen

Related MCP server: mcp-evolution

Voraussetzungen

• Docker Desktop

• Python 3.11+

• uv (Python-Paketmanager)

• Claude Code

Installation

1. Evolution API starten

git clone https://github.com/SEU_USUARIO/evolution-api-mcp.git
cd evolution-api-mcp
docker compose up -d

Warten Sie etwa 15 Sekunden und testen Sie es:

curl http://localhost:8080/

Es sollte {"status":200,"message":"Welcome to the Evolution API, it is working!"} zurückgegeben werden.

2. MCP-Server installieren

uv venv
uv pip install -e .

3. In Claude Code registrieren

claude mcp add evolution-api -s user -- evolution-api-mcp

Oder fügen Sie es manuell in der Datei ~/.claude.json hinzu:

{
  "mcpServers": {
    "evolution-api": {
      "type": "stdio",
      "command": "evolution-api-mcp",
      "env": {
        "EVOLUTION_API_URL": "http://localhost:8080",
        "EVOLUTION_API_KEY": "evo_mcp_2024"
      }
    }
  }
}

Windows: Der Befehl benötigt möglicherweise den vollständigen Pfad zur .exe: C:/Users/IHR_BENUTZERNAME/evolution-api-mcp/.venv/Scripts/evolution-api-mcp.exe

4. WhatsApp verbinden

1. Öffnen Sie http://localhost:8080/manager/ im Browser

2. Verwenden Sie den Global API Key: evo_mcp_2024

3. Erstellen Sie eine Instanz (z. B. "meinwhatsapp")

4. Klicken Sie auf "QR-Code generieren"

5. Scannen Sie diesen mit Ihrem WhatsApp: Einstellungen > Verknüpfte Geräte > Gerät hinzufügen

5. Loslegen!

Starten Sie Claude Code neu und beginnen Sie mit der Nutzung:

> envia uma mensagem pro 5511999999999 dizendo oi
> mostra minhas conversas recentes
> envia uma foto pra fulano

Konfiguration

Der Standard-API-Schlüssel von Docker Compose ist evo_mcp_2024. Ändern Sie diesen bei Bedarf in der docker-compose.yml.

Struktur

evolution-api-mcp/
├── docker-compose.yml          # Evolution API + PostgreSQL
├── pyproject.toml               # Dependencias Python
└── src/evolution_api_mcp/
    ├── server.py                # MCP server (FastMCP + CodeMode)
    ├── client.py                # HTTP client async
    └── tools/
        ├── instance.py          # Criar/conectar/deletar instancias
        ├── messages.py          # Enviar texto, midia, audio, etc.
        └── chat.py              # Listar chats, ler mensagens

Verfügbare Tools

Instanz

• create_instance - WhatsApp-Instanz erstellen

• connect_instance - Verbinden und QR-Code generieren

• fetch_instances - Instanzen auflisten

• connection_state - Verbindungsstatus prüfen

• logout_instance - WhatsApp abmelden

• restart_instance - Instanz neu starten

• delete_instance - Instanz löschen

Nachrichten

• send_text - Text senden

• send_media - Bild, Video oder Dokument senden

• send_audio - Audio/Sprachnachricht senden

• send_location - Standort senden

• send_contact - Kontaktkarte senden

• send_reaction - Mit Emoji reagieren

• send_poll - Umfrage senden

• send_buttons - Interaktive Schaltflächen senden

• send_list - Interaktive Liste senden

• send_sticker - Sticker senden

Chat

• find_chats - Unterhaltungen auflisten

• find_messages - Nachrichten eines Chats lesen

• archive_chat - Chat archivieren/dearchivieren

• mark_message_as_read - Als gelesen markieren

Lizenz

MIT