de en es ja ko ru zh

mcp-evolution

Name: mcp-evolution
Author: billyfranklim1

by billyfranklim1

Overview Schema Related Servers Score Discussions

TypeScript

Remote

mcp-evolution

npm version license

TypeScript MCP-Server für die Evolution API (WhatsApp) mit Instanz-Pinning.

Architektur

Dieser Server implementiert das Model Context Protocol:

Transport: stdio — der MCP-Host (Claude Desktop, Claude Code, etc.) startet diesen Prozess und kommuniziert via JSON-RPC über stdin/stdout.
Server: verwendet die High-Level McpServer-Klasse aus dem offiziellen TypeScript SDK, die die Fähigkeitsaushandlung und den Sitzungslebenszyklus automatisch handhabt.
Tools: 50 Tools, die über registerTool() mit Zod-validierten Eingabeschemata registriert sind — das SDK erzwingt die Typen, bevor der Handler ausgeführt wird.

Alle drei Verbindungsparameter (API-URL, API-Schlüssel, Instanzname) werden beim Start über Umgebungsvariablen fixiert. Der KI-Aufrufer kann während einer Konversation nicht zwischen Instanzen wechseln.

Related MCP server: mcp-evolution-api

Tools

Nachricht

Tool	Beschreibung
`send_text`	Sendet eine einfache Textnachricht
`send_media`	Sendet ein Bild, Video, Audio oder Dokument
`send_audio`	Sendet ein WhatsApp-Audio (PTT-Sprachnachricht)
`send_sticker`	Sendet einen Sticker (webp)
`send_location`	Sendet einen Standort-Pin
`send_contact`	Teilt einen oder mehrere Kontakte (vCards)
`send_reaction`	Reagiert auf eine Nachricht mit einem Emoji
`send_poll`	Sendet eine Umfrage-Nachricht
`send_list`	Sendet eine interaktive Listen-/Menü-Nachricht
`send_button`	Sendet eine interaktive Button-Nachricht
`send_status`	Veröffentlicht ein WhatsApp-Status-Update (Story)

Chat

Tool	Beschreibung
`find_chats`	Findet Chats, optional gefiltert mit einer Prisma-artigen `where`-Klausel
`find_contacts`	Findet Kontakte, optional gefiltert
`find_messages`	Findet Nachrichten nach remoteJid mit optionalem Limit
`get_chat_history`	Ruft den Nachrichtenverlauf für einen Kontakt oder eine Gruppen-JID ab
`mark_as_read`	Markiert eine oder mehrere Nachrichten als gelesen
`archive_chat`	Archiviert oder dearchiviert einen Chat
`delete_message`	Löscht eine Nachricht für alle
`fetch_profile_picture`	Ruft die Profilbild-URL eines Kontakts ab
`download_media`	Lädt Medien aus einer Nachricht als Base64 herunter
`send_presence`	Sendet ein Präsenz-Update (tippt, nimmt auf, etc.)
`check_number`	Überprüft, ob Telefonnummern WhatsApp-Konten haben

Profil

Tool	Beschreibung
`fetch_business_profile`	Ruft das WhatsApp-Business-Profil eines Kontakts ab
`update_profile_name`	Aktualisiert den Anzeigenamen der Instanz
`update_profile_status`	Aktualisiert den Info-/Status-Text der Instanz
`update_profile_picture`	Aktualisiert das Profilbild der Instanz
`remove_profile_picture`	Entfernt das Profilbild der Instanz
`fetch_privacy`	Ruft die aktuellen Datenschutzeinstellungen ab
`update_privacy`	Aktualisiert die Datenschutzeinstellungen
`update_block_status`	Blockiert oder entblockt einen Kontakt

Gruppe

Tool	Beschreibung
`list_groups`	Listet alle WhatsApp-Gruppen für die fixierte Instanz auf
`get_group_info`	Ruft detaillierte Informationen für eine bestimmte Gruppe per JID ab
`create_group`	Erstellt eine neue WhatsApp-Gruppe
`update_group_subject`	Aktualisiert den Namen einer Gruppe
`update_group_description`	Aktualisiert die Beschreibung einer Gruppe
`update_group_picture`	Aktualisiert das Profilbild einer Gruppe
`fetch_invite_code`	Ruft den Einladungscode/-link für eine Gruppe ab
`revoke_invite_code`	Widerruft und generiert den Einladungscode einer Gruppe neu
`accept_invite`	Akzeptiert eine Gruppeneinladung per Code
`send_group_invite`	Sendet einen Gruppeneinladungslink an bestimmte Kontakte
`update_participants`	Fügt Gruppenmitglieder hinzu, entfernt, befördert oder degradiert sie
`update_group_setting`	Aktualisiert Gruppeneinstellungen (Ankündigungsmodus, gesperrt)
`leave_group`	Verlässt eine Gruppe
`find_group_by_invite`	Ruft Gruppeninformationen über einen Einladungscode ab, ohne beizutreten

Instanz

Tool	Beschreibung
`connection_state`	Ruft den aktuellen Verbindungsstatus der Instanz ab
`restart_instance`	Startet die Instanz neu (verbindet sich neu, ohne sich abzumelden)
`logout_instance`	Meldet die Instanz ab (löscht die Sitzung)
`get_settings`	Ruft die aktuellen Instanzeinstellungen ab
`set_settings`	Aktualisiert die Instanzeinstellungen

Webhook

Tool	Beschreibung
`find_webhook`	Ruft die aktuelle Webhook-Konfiguration ab
`set_webhook`	Konfiguriert den Webhook

Label

Tool	Beschreibung
`find_labels`	Listet alle Labels auf (erfordert WhatsApp Business)
`handle_label`	Fügt ein Label zu einem Chat hinzu oder entfernt es

Installation & Ausführung via npx

EVOLUTION_API_URL=http://localhost:8080 \
EVOLUTION_API_KEY=your-key \
EVOLUTION_INSTANCE=your-instance \
npx mcp-evolution

Konfiguration

Variable	Erforderlich	Beschreibung
`EVOLUTION_API_URL`	Ja	Basis-URL Ihrer Evolution API (z. B. `http://localhost:8080`)
`EVOLUTION_API_KEY`	Ja	Globaler API-Schlüssel aus der Evolution API-Konfiguration
`EVOLUTION_INSTANCE`	Ja	Instanzname, der in der Evolution API erstellt wurde

Kopieren Sie .env.example nach .env für die lokale Entwicklung.

Verwendung mit Claude Desktop / Claude Code

Fügen Sie dies zu ~/.claude/claude_desktop_config.json oder dem Projekt .mcp.json hinzu:

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

Oder verweisen Sie direkt auf die gebaute Binärdatei, wenn Sie aus einem lokalen Checkout ausführen:

{
  "mcpServers": {
    "whatsapp": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-evolution/dist/index.js"],
      "env": {
        "EVOLUTION_API_URL": "http://localhost:8080",
        "EVOLUTION_API_KEY": "your-evolution-api-key",
        "EVOLUTION_INSTANCE": "your-instance-name"
      }
    }
  }
}

Entwicklung

# Install dependencies
npm install

# Run in dev mode (no build step)
npm run dev

# Build TypeScript → dist/
npm run build

# Run tests
npm test

# Start from built output
npm start

Eingebundene Evolution API-Endpunkte

Tool	Methode	Pfad
`send_text`	POST	`/message/sendText/{instance}`
`send_media`	POST	`/message/sendMedia/{instance}`
`send_audio`	POST	`/message/sendWhatsAppAudio/{instance}`
`send_sticker`	POST	`/message/sendSticker/{instance}`
`send_location`	POST	`/message/sendLocation/{instance}`
`send_contact`	POST	`/message/sendContact/{instance}`
`send_reaction`	POST	`/message/sendReaction/{instance}`
`send_poll`	POST	`/message/sendPoll/{instance}`
`send_list`	POST	`/message/sendList/{instance}`
`send_button`	POST	`/message/sendButtons/{instance}`
`send_status`	POST	`/message/sendStatus/{instance}`
`find_chats`	POST	`/chat/findChats/{instance}`
`find_contacts`	POST	`/chat/findContacts/{instance}`
`find_messages` / `get_chat_history`	POST	`/chat/findMessages/{instance}`
`mark_as_read`	POST	`/chat/markMessageAsRead/{instance}`
`archive_chat`	POST	`/chat/archiveChat/{instance}`
`delete_message`	DELETE	`/chat/deleteMessageForEveryone/{instance}`
`fetch_profile_picture`	POST	`/chat/fetchProfilePictureUrl/{instance}`
`download_media`	POST	`/chat/getBase64FromMediaMessage/{instance}`
`send_presence`	POST	`/chat/sendPresence/{instance}`
`check_number`	POST	`/chat/whatsappNumbers/{instance}`
`fetch_business_profile`	POST	`/chat/fetchBusinessProfile/{instance}`
`update_profile_name`	POST	`/chat/updateProfileName/{instance}`
`update_profile_status`	POST	`/chat/updateProfileStatus/{instance}`
`update_profile_picture`	POST	`/chat/updateProfilePicture/{instance}`
`remove_profile_picture`	DELETE	`/chat/removeProfilePicture/{instance}`
`fetch_privacy`	GET	`/chat/fetchPrivacySettings/{instance}`
`update_privacy`	POST	`/chat/updatePrivacySettings/{instance}`
`update_block_status`	POST	`/chat/updateBlockStatus/{instance}`
`list_groups`	GET	`/group/fetchAllGroups/{instance}`
`get_group_info`	GET	`/group/findGroupInfos/{instance}`
`create_group`	POST	`/group/create/{instance}`
`update_group_subject`	POST	`/group/updateGroupSubject/{instance}?groupJid=`
`update_group_description`	POST	`/group/updateGroupDescription/{instance}?groupJid=`
`update_group_picture`	POST	`/group/updateGroupPicture/{instance}?groupJid=`
`fetch_invite_code`	GET	`/group/inviteCode/{instance}?groupJid=`
`revoke_invite_code`	POST	`/group/revokeInviteCode/{instance}?groupJid=`
`accept_invite`	GET	`/group/acceptInviteCode/{instance}?inviteCode=`
`send_group_invite`	POST	`/group/sendInvite/{instance}`
`update_participants`	POST	`/group/updateParticipant/{instance}?groupJid=`
`update_group_setting`	POST	`/group/updateSetting/{instance}?groupJid=`
`leave_group`	DELETE	`/group/leaveGroup/{instance}?groupJid=`
`find_group_by_invite`	GET	`/group/inviteInfo/{instance}?inviteCode=`
`connection_state`	GET	`/instance/connectionState/{instance}`
`restart_instance`	POST	`/instance/restart/{instance}`
`logout_instance`	DELETE	`/instance/logout/{instance}`
`get_settings`	GET	`/settings/find/{instance}`
`set_settings`	POST	`/settings/set/{instance}`
`find_webhook`	GET	`/webhook/find/{instance}`
`set_webhook`	POST	`/webhook/set/{instance}`
`find_labels`	GET	`/label/findLabels/{instance}`
`handle_label`	POST	`/label/handleLabel/{instance}`

Erfordert Evolution API v2.

Lizenz

MIT — siehe LICENSE.

Haftungsausschluss

Community-Software, nicht mit der Evolution API oder einer WhatsApp-Einheit verbunden.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

mcp-zap
Communication App Automation
Joaquim-Salles
F
license
Not graded
quality
D
maintenance
MCP server for sending and receiving WhatsApp messages through Evolution API, enabling management of instances, messages, and chats directly from Claude Code.
Updated 3 months ago (2026-05-09 22:12 UTC)
mcp-evolution-api
Communication Customer Support
pauloFroes
F
license
A
quality
D
maintenance
MCP server that wraps the Evolution API (WhatsApp) as semantic tools for LLM agents, enabling messaging, chat management, group operations, and instance control via natural language.
Updated 6 months ago (2026-03-02 17:10 UTC)
32
Evolution MCP Server
Communication Developer Tools
MatheusLarcher
F
license
Not graded
quality
D
maintenance
MCP server for managing WhatsApp instances and sending messages through Evolution API.
Updated 10 months ago (2025-10-08 13:02 UTC)
1
MCP-WHATSAPP-EVO
Communication Social Media
jppeiro90
A
license
C
quality
C
maintenance
Exposes the full WhatsApp API via Evolution API, enabling message sending, chat history, group management, and more through MCP tools.
Updated 2 months ago (2026-06-30 02:47 UTC)
70
MIT

View all related MCP servers

Related MCP Connectors

omnidim-mcp-server
Official MCP server for OmniDimension. Drive voice agents, dispatch calls, and run bulk campaigns.
mcp-aichat
MCP server for AI dialogue using various LLM models via AceDataCloud
vonage-documentation-mcp
MCP server for Vonage API documentation, code snippets, tutorials, and troubleshooting.

View all MCP Connectors

Appeared in Searches

WhatsApp MCP (Model Context Protocol) Integration

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/billyfranklim1/mcp-evolution'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

mcp-evolution

Architektur

Tools

Nachricht

Chat

Profil

Gruppe

Instanz

Webhook

Label

Installation & Ausführung via npx

Konfiguration

Verwendung mit Claude Desktop / Claude Code

Entwicklung

Eingebundene Evolution API-Endpunkte

Lizenz

Haftungsausschluss

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

mcp-zap

mcp-evolution-api

Evolution MCP Server

MCP-WHATSAPP-EVO

Related MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API