whatsapp-mcp-plus

Ein sicherer WhatsApp-MCP-Server ganz ohne Einrichtung. Read-first und standardmäßig sicher.

Er verbindet dein persönliches WhatsApp mit einem MCP-Client (Claude Desktop, Cursor, Claude Code), damit deine KI in WhatsApp suchen, lesen, zusammenfassen und – wenn du es erlaubst – auch handeln kann, mit Sicherheitsvorkehrungen, die dein Konto schützen.

Dies ist der gepflegte, als einzelne Binärdatei ausgelieferte Nachfolger des (inzwischen eingestellten) lharries/whatsapp-mcp, neu aufgebaut in TypeScript auf Basis von Baileys – mit einer Sicherheitsebene, die es nie hatte.

⚠️ Lies vor der Verwendung den Hinweis zur Kontosicherheit. Dieses Tool nutzt einen inoffiziellen WhatsApp-Client. Bei unvorsichtiger Verwendung kann deine Nummer gesperrt werden. Dieses Tool wurde entwickelt, um dieses Risiko zu minimieren, kann es aber nicht ausschließen.

WhatsApp Rewind, aus deinen eigenen Chats

Bitte deine KI, whatsapp_rewind auszuführen, um aus deinem Verlauf ein Story-Karten-Set im Spotify-Wrapped-Stil (1080×1920 SVG) zu erstellen – Cover, Top-Kontakte, deinen Tagesrhythmus, Top-Emojis, Antwortgeschwindigkeits-Rangliste und die nackten Zahlen:

Lieber eine einzelne Karte? wrapped_card erstellt eine einzelne teilbare SVG; whatsapp_wrapped gibt eine Terminal-Karte aus. Außerdem: response_leaderboard (wem du am schnellsten antwortest / wen du am längsten auf „gelesen“ stehen lässt), chat_stats (pro Chat, mit Antwortzeiten), top_words und export_chat.

Related MCP server: WA MCP

Warum das hier statt des Originals

Schnellstart

npx whatsapp-mcp-plus

Beim ersten Start wird ein QR-Code im Terminal angezeigt. Öffne WhatsApp auf deinem Telefon → Einstellungen → Verknüpfte Geräte → Gerät koppeln und scanne ihn. Dein bisheriger Verlauf wird in eine lokale SQLite-Datenbank synchronisiert. Nichts verlässt deinen Computer, außer dem, was die KI ausdrücklich über einen Tool-Aufruf liest.

Oder mit Docker (Verbindung und Server in einem Container):

docker build -t whatsapp-mcp-plus .
docker run -it -v wamcp-data:/app/data -v wamcp-auth:/app/auth_info whatsapp-mcp-plus

Analysen ohne Kopplung ansehen

Du möchtest sehen, was whatsapp_wrapped und response_leaderboard erzeugen? Starte die Demo: Sie befüllt eine Beispieldatenbank und gibt die echte Tool-Ausgabe aus:

npm run demo

In deinen MCP-Client einbinden

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "whatsapp-mcp-plus"],
      "env": { "WAMCP_MODE": "read-only" }
    }
  }
}

• Claude Desktop: claude_desktop_config.json

• Cursor: ~/.cursor/mcp.json

Sicherheitsmodell (standardmäßig sicher)

WhatsApp-Sperren sind meist verhaltensbedingt. Lesen ist risikoarm; unaufgeforderte oder massenhafte Nachrichten sind risikoreich. Die Standardwerte sind so kalibriert, dass du im sicheren Bereich bleibst.

Modi (WAMCP_MODE):

• read-only (Standard) – jedes Schreib-Tool ist blockiert. Nur suchen/lesen/analysieren.

• assisted – Senden erlaubt, aber durch Allowlist + Ratenbegrenzung + Bestätigung abgesichert.

• unrestricted – Sicherheitsvorkehrungen abgeschaltet (Opt-in, nicht empfohlen).

Sicherheitsvorkehrungen (außerhalb von unrestricted standardmäßig aktiv):

• Allowlist – Du kannst nur bestehende Kontakte oder Personen anschreiben, die dir zuerst geschrieben haben (Fremde anzuschreiben ist der häufigste Auslöser für Sperren). Einzelne Kontakte kannst du mit dem Tool allowlist_add manuell freischalten.

• Ratenbegrenzung – Obergrenzen pro Minute und pro Tag sowie eine menschenähnliche Pause mit Jitter zwischen den Sendevorgängen.

• Bestätigung vor dem Senden – ein Sendeversuch gibt ein Token zurück und wartet; nichts geht raus, bis du confirm_action aufrufst. Das verhindert, dass eine per Prompt-Injection eingeschleuste Nachricht abgesetzt wird.

• Injection-Guard – eingehende Nachrichten, die wie Anweisungen an eine KI aussehen, werden markiert, damit das Modell sie als Daten und nicht als Befehle behandelt.

Jede Einstellung ist eine Umgebungsvariable: WAMCP_ALLOWLIST_ONLY, WAMCP_REQUIRE_CONFIRM, WAMCP_RATE_PER_MINUTE, WAMCP_RATE_PER_DAY, WAMCP_MIN_GAP_MS, WAMCP_JITTER_MS.

Tools

51 Tools (das eingestellte Original hatte 12):

Lesen: search_contacts, list_chats, list_groups, get_chat, list_messages (mit Datumsbereich), get_last_interaction, contact_info, get_message_context, search_messages Senden: send_message (mit Antwort), send_file, send_voice_note, send_location, send_poll, send_contact Nachrichtenaktionen: react_to_message, edit_message, delete_message, mark_read, forward_message, star_message Gruppen: group_info, create_group, group_update_participants, group_set_subject, group_set_description, group_invite_link, group_leave Chat-Verwaltung: pin_chat, mute_chat, block_contact, check_number_on_whatsapp, get_profile_picture Präsenz / Profil: send_presence, set_profile_status, set_profile_name Medien / Intelligenz: download_media, transcribe_voice_message Analysen: whatsapp_rewind (Story-Set mit 6 Karten), wrapped_card (einzelne teilbare SVG), whatsapp_wrapped (Terminal-Karte), response_leaderboard (wem du am schnellsten antwortest / wen du am längsten auf „gelesen“ stehen lässt), top_words, chat_stats (pro Chat, inkl. Antwortzeiten), export_chat (Markdown-/Text-Transkript) Steuerung: get_status, get_me, set_mode, confirm_action, allowlist_add/remove/list

Sprachtranskription

transcribe_voice_message lädt eine Sprachnachricht herunter und führt sie – wenn du WAMCP_TRANSCRIPTION_CMD gesetzt hast (ein Befehl, der {input} enthält und ein Transkript ausgibt) – mit deiner bevorzugten Spracherkennung (z. B. whisper) aus. Ohne diese Einstellung wird die Audiodatei trotzdem heruntergeladen und ihr Pfad zurückgegeben.

Konfigurationsreferenz

Kontosicherheit & Nutzungsbedingungen

Dieses Projekt verwendet Baileys, einen inoffiziellen WhatsApp-Web-Client. Die Automatisierung eines persönlichen WhatsApp-Kontos verstößt gegen die Nutzungsbedingungen von WhatsApp und kann dazu führen, dass deine Nummer vorübergehend oder dauerhaft gesperrt wird. Um dieses Risiko zu verringern:

• Behalte den Standardmodus read-only bei, es sei denn, du musst wirklich etwas senden.

• Verwende es niemals für unaufgeforderte Kontaktaufnahme, Massennachrichten oder identische/Spam-Nachrichten.

• Bevorzuge eine etablierte, viel genutzte Nummer gegenüber einer frischen SIM; vermeide VoIP-Nummern.

• Behandle es als persönlichen Assistenten, nicht als Marketing-Werkzeug.

Mit der Nutzung des Tools akzeptierst du dieses Risiko. Es wird wie besehen für den persönlichen und Bildungsgebrauch bereitgestellt, ohne Gewährleistung. Nicht mit WhatsApp oder Meta verbunden.

Danksagungen

Abgeleitet von whatsapp-mcp-ts (ISC) und whatsapp-mcp (MIT). Siehe NOTICE. MIT-lizenziert.