WhatsApp MCP

npx add-mcp 'https://server.wa-mcp.com/mcp'

WhatsApp MCP Dokumentation

WhatsApp MCP verbindet deinen KI-Assistenten (Claude, ChatGPT, Cursor oder jeden Client, der das Model Context Protocol unterstützt) mit der WhatsApp-Nummer, die du bereits verwendest. Dein Assistent kann deine Chats lesen und durchsuchen, sehen, wer auf eine Antwort wartet, und Nachrichten senden, planen, bearbeiten oder darauf reagieren – immer von deiner eigenen Nummer aus und nur, wenn du es verlangst.

Es verbindet sich mit WhatsApp als verknüpftes Gerät, genauso wie WhatsApp Web. Es gibt keine App zum Installieren, keine neue Nummer und keine Meta Business API.

Einrichtung

Du verbindest dich einmal, dann verknüpfst du dein WhatsApp im Chat.

Option A: Claudes Connector-Verzeichnis

1. Öffne in Claude das Connector-Verzeichnis und suche WhatsApp MCP.
2. Klicke auf Verbinden. Unsere Verbindungsseite öffnet sich: Prüfe, ob deine KI-App genannt wird, und klicke dann erneut auf Verbinden.
3. Öffne zurück in Claude einen neuen Chat und tippe „Verbinde mein WhatsApp" (siehe „Dein WhatsApp verknüpfen" unten).

Es gibt keine Registrierung und kein Passwort: Deine WhatsApp-Nummer ist dein Konto, und durch die Verknüpfung wissen wir, dass du es bist.

Option B: eine persönliche Verbindungs-URL (jeder MCP-Client)

1. Gehe zu wa-mcp.com, wähle deine KI-App und klicke auf Meinen Link generieren.
2. Füge den Link in deiner KI-App als benutzerdefinierten Connector (MCP-Server) hinzu. Die Website zeigt die genauen Schritte für jede App, und How to Connect Claude to WhatsApp führt dich Schritt für Schritt durch Claude.
3. Öffne einen neuen Chat und tippe „Verbinde mein WhatsApp".

Halte den Link geheim: Er funktioniert wie ein Passwort. Du kannst denselben Link in mehreren KI-Apps verwenden.

Dein WhatsApp verknüpfen

Wenn du deinen Assistenten bittest, dein WhatsApp zu verbinden, bietet er zwei Wege an:

• QR-Code: Dein Assistent zeigt einen QR-Code (und einen Link zu einer Seite damit). Öffne auf deinem Telefon WhatsApp → Einstellungen → Verknüpfte Geräte → Gerät verknüpfen und scanne ihn.
• Kopplungscode: Gib deinem Assistenten deine Telefonnummer mit Ländervorwahl. Er gibt einen 8-stelligen Code zurück. Öffne auf deinem Telefon Verknüpfte Geräte → Gerät verknüpfen → Mit Telefonnummer verknüpfen und gib den Code ein.

Nach der Verknüpfung synchronisiert WhatsApp deinen aktuellen Verlauf (bis zu etwa 90 Tage) mit dem verknüpften Gerät, was bei großen Konten einige Minuten dauern kann.

Tarife

• Kostenlose Testphase: alle Funktionen für 1 Stunde, nachdem du zum ersten Mal ein Telefon verknüpft hast.
• Kostenloser Tarif: Nach der Testphase funktionieren das Lesen, Zusammenfassen und Durchsuchen von Chats sowie das Senden von Textnachrichten weiterhin. Textnachrichten enden mit „Sent via wa-mcp.com", und neue Unterhaltungen (Personen, die dir in den letzten 90 Tagen nicht geschrieben haben) können nicht begonnen werden.
• Kostenpflichtiger Tarif: Dateien (Fotos, Videos, Sprachnachrichten, Dokumente), geplante Nachrichten, Bearbeiten, Reagieren auf und Löschen von Nachrichten, neue Unterhaltungen mit Anti-Sperr-Schutzmaßnahmen und keine Kennzeichnung.

Frage deinen Assistenten „Welchen Tarif habe ich?", um deinen Tarif und die Abonnementoptionen zu sehen.

Werkzeuge

Dein Assistent wählt die Werkzeuge aus; du fragst einfach in normalen Worten.

Lesen

Werkzeug	Was es tut
get_recent_chats	Deine neuesten Chats mit der jeweils letzten Nachricht.
get_unanswered_chats	Chats, in denen die letzte Nachricht von der anderen Person stammt, damit du siehst, wer auf eine Antwort wartet.
read_chat_history	Die Nachrichten eines Chats, einer Person oder einer Gruppe.
search_messages	Durchsucht den Text deiner Nachrichten, optional in einem Chat oder von einer Person.
search_contacts	Findet einen Kontakt oder eine Gruppe anhand von Name oder Nummer.
download_media	Öffnet ein Foto, eine Sprachnachricht, ein Video, ein Dokument oder einen Sticker aus einer Nachricht.
get_writing_style	Beispiele dafür, wie du schreibst, damit für dich verfasste Entwürfe wie von dir klingen.

Schreiben

Werkzeug	Was es tut
send_message	Sendet einen Text oder eine Datei von einem Link an eine Person oder Gruppe. Zeigt zuerst einen Tippindikator an.
schedule_message	Plant eine Nachricht für später, einmalig oder wiederkehrend (täglich, wöchentlich, monatlich und mehr).
list_scheduled_messages	Listet bevorstehende geplante Nachrichten und den Verlauf vergangener auf.
cancel_scheduled_message	Bricht eine geplante Nachricht ab (alle ihre Wiederholungen).
react_to_message	Reagiert mit einem Emoji auf eine Nachricht oder entfernt die Reaktion.
edit_message	Ändert den Text einer deiner eigenen Nachrichten.
delete_message	Löscht eine deiner eigenen Nachrichten für alle.
mark_as_read	Markiert einen Chat als gelesen.

Verbindung und Konto

Werkzeug	Was es tut
get_session_status	Ob dein WhatsApp verknüpft und verbunden ist.
get_pairing_qr	Startet die Verknüpfung mit einem QR-Code.
request_pairing_code	Startet die Verknüpfung mit einem Kopplungscode.
restart_session	Verbindet sich erneut mit WhatsApp, wenn keine Nachrichten mehr ankommen.
manage_subscription	Zeigt deinen Tarif und die Abonnementoptionen.
report_feedback	Sendet uns einen Fehlerbericht oder Funktionswunsch.
unlink_whatsapp	Hebt die Verknüpfung deines WhatsApp auf (dein Konto bleibt bestehen).
delete_account	Löscht dein Konto und alle seine Daten, nachdem du bestätigt hast.

Beispiel-Prompts

• „Wer wartet seit gestern auf eine Antwort von mir?"
• „Fasse zusammen, worüber die Familiengruppe diese Woche gesprochen hat."
• „Finde die Nachricht, in der Carlos mir die Adresse geschickt hat."
• „Sag Ana, dass die Bestellung am Donnerstag verschickt wird." (dein Assistent zeigt zuerst den Entwurf, es sei denn, du hast die genauen Worte vorgegeben)
• „Erinnere die Teamgruppe jeden Montag um 9 Uhr daran, ihr wöchentliches Update zu senden."

Sicherheit

• Du behältst die Kontrolle darüber, was gesendet wird. Wenn dein Assistent eine Nachricht für dich schreibt, zeigt er dir den Entwurf vor dem Senden, es sei denn, du hast ihm den genauen Text vorgegeben.
• Anti-Sperr-Schutzmaßnahmen. Nachrichten an Personen, die dir in den letzten 90 Tagen nicht geschrieben haben, werden zeitlich gestaffelt (höchstens 1 pro Minute und 10 verschiedene Personen alle 12 Stunden), weil genau das Nummern als Spam markieren lässt. Chats mit Personen, die dir geschrieben haben, sind nie begrenzt. Es gibt keine Werkzeuge für Massenversand.
• Tippindikator. Vor jeder Nachricht erscheint kurz ein „schreibt…", so wie es wäre, wenn du selbst tippen würdest.

Fehlerbehebung

• „WhatsApp ist nicht verknüpft": Das verknüpfte Gerät wurde entfernt (von deinem Telefon oder durch Aufheben der Verknüpfung). Bitte deinen Assistenten, dein WhatsApp erneut mit derselben Nummer zu verbinden.
• Der Kopplungscode funktioniert nicht: Codes laufen nach kurzer Zeit ab. Fordere einen neuen an, prüfe, ob die Nummer die Ländervorwahl enthält, und verwende auf deinem Telefon Mit Telefonnummer verknüpfen.
• Nachrichten kommen nicht mehr an: Bitte deinen Assistenten, deine WhatsApp-Verbindung neu zu starten. Wenn WhatsApp auf deinem Telefon etwa 14 Tage lang offline war, meldet WhatsApp verknüpfte Geräte ab: Öffne WhatsApp auf deinem Telefon und verknüpfe dann erneut.
• „This connection is permanently registered to phone number…": Jede Verbindung gehört zu einem Telefon. Um eine andere Nummer zu verwenden, hebe die Verknüpfung auf, entferne dann den Connector und füge ihn erneut hinzu (oder generiere mit einer persönlichen URL eine neue).
• Der Connector meldet, dass er nicht verbunden ist (Nutzer des Verzeichnisses): Entferne WhatsApp MCP aus deinen Connectors und verbinde es erneut, dann verknüpfe dasselbe Telefon. Dein Konto und dein Abonnement bleiben erhalten.

Datenschutz und deine Daten

Deine Nachrichten werden 90 Tage lang auf unseren Servern gespeichert, damit dein Assistent sie durchsuchen kann, und werden niemals für Werbung oder KI-Training verwendet. Was dein Assistent liest, wird von seinem Anbieter gemäß dessen Richtlinien verarbeitet. Bitte deinen Assistenten jederzeit, dein WhatsApp zu entkoppeln oder dein Konto zu löschen; beim Löschen wird alles sofort entfernt. Die vollständigen Details findest du in unserer Privacy Policy und den Terms.