Skip to main content
Glama
wazap-mcp

wazap-mcp

by razvangirgiz
██╗    ██╗ █████╗ ███████╗ █████╗ ██████╗
██║    ██║██╔══██╗╚══███╔╝██╔══██╗██╔══██╗
██║ █╗ ██║███████║  ███╔╝ ███████║██████╔╝
██║███╗██║██╔══██║ ███╔╝  ██╔══██║██╔═══╝
╚███╔███╔╝██║  ██║███████╗██║  ██║██║
 ╚══╝╚══╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝

WhatsApp für deinen KI-Agenten. Ein MCP-Server, der dein WhatsApp-Konto – Chats, Nachrichten, Medien, Kontakte, Gruppen – hinter 22 Tools stellt, die jeder MCP-Client aufrufen kann. Anmeldung per Pairing-Code, kein Browser, kein Telefonnummern-Wiederverkäufer, ~20 MB RAM.

Basiert auf Baileys, das das WhatsApp-Multi-Device-Protokoll über eine WebSocket-Verbindung spricht.

Erste Schritte

Das npm-Paket ist wazap-mcp; der Befehl, den es installiert, ist wazap.

npx wazap-mcp setup

Das ist die gesamte Installation. Es verknüpft dein Konto, findet die auf diesem Rechner installierten MCP-Clients, schreibt deren Konfiguration und sagt dir, was du neu starten musst.

Oder lass deinen Agenten das erledigen. Füge dies ein:

Richte WhatsApp für mich ein: Führe npx wazap-mcp setup --agent aus und folge dem, was es ausgibt.

Dann frag deinen Agenten: „Was habe ich heute auf WhatsApp verpasst?"

Im Folgenden sind die Schritte, die setup für dich ausführt. Jeder ist weiterhin ein eigener Befehl, wenn du ihn von Hand ausführen möchtest.

npx wazap-mcp login zeigt einen QR-Code; scanne ihn unter Einstellungen → Verknüpfte Geräte → Gerät verknüpfen. Keine Kamera zur Hand oder Verknüpfung über SSH? npx wazap-mcp login --phone +15550100 gibt einen 8-stelligen Code aus, den du unter Stattdessen mit Telefonnummer verknüpfen eingibst. Am Ende fragt es, ob der Agent Nachrichten senden darf; die Antwort ist nein, es sei denn, du sagst ja, und npx wazap-mcp config writes on ändert das später.

npx wazap-mcp connect claude-code schreibt den MCP-Eintrag für einen Client. Die Tabelle unter Client verbinden enthält den Rest.

npx wazap-mcp allein ist sicher auszuführen: Es zeigt, wo du stehst und was als Nächstes zu tun ist, und startet keinen Server. Wenn etwas nicht stimmt, ist npx wazap-mcp status das Erste, was du ausführen solltest – es prüft Node, das Datenverzeichnis, die Sperre, die Anmeldedaten und ob eine neuere Version verfügbar ist, und zeigt neben jedem Problem die Lösung an.

Client verbinden

wazap connect <client> schreibt den Eintrag für dich, behält alles andere in der Datei und sichert sie einmal vor der ersten Änderung. --dry-run zeigt, was es schreiben würde.

Client

Was connect schreibt

claude-code

führt claude mcp add whatsapp für dich aus

claude-desktop

claude_desktop_config.json im Claude-Anwendungsverzeichnis

cursor

~/.cursor/mcp.json

codex

[mcp_servers.whatsapp] in ~/.codex/config.toml

vscode

./.vscode/mcp.json, für den aktuellen Arbeitsbereich

gemini

~/.gemini/settings.json

alles Remote

MCP-URL-Feld des Clients: https://your-host/mcp mit Header Authorization: Bearer <token> (siehe Self-host)

Jeder MCP-Client funktioniert auf die gleiche Weise: Der Befehl ist npx -y wazap-mcp, der Transport ist stdio. Sag dem Agenten, er soll zuerst learn aufrufen – es gibt die ID-Formate, die Arbeitsabläufe und jeden Fehlercode mit Hinweisen zur Behebung zurück.

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "wazap-mcp"]
    }
  }
}

Claude Desktop, Cursor und Gemini CLI übernehmen genau das. VS Code verschachtelt es unter servers und möchte ein "type": "stdio" neben command. Codex CLI ist TOML:

[mcp_servers.whatsapp]
command = "npx"
args = ["-y", "wazap-mcp"]

Der Ordner skills/ folgt dem Agent Skills-Format, sodass Codex, Cursor und andere skill-bewusste Agenten dieselben fünf Skills laden können.

Related MCP server: wa-bridge

Tools

Tool

Kind

Was es tut

learn

read

Der Leitfaden zu jedem Tool, ID-Format und Fehlercode. Rufe es zuerst auf.

get_status

read

Verbindungsstatus, Synchronisierungszustand, verknüpftes Konto, Versionen, Datenverzeichnis.

list_chats

read

Unterhaltungen neueste zuerst; filtere all/unread/groups/individual/archived.

read_messages

read

Nachrichten in einem Chat; before blättert weiter zurück und holt ältere Verläufe vom Telefon.

get_recent_messages

read

Alles aus den letzten N Stunden, gruppiert nach Chat. Das Aufhol-Tool.

search_messages

read

Textsuche über die lokal gespeicherten Nachrichten.

get_message

read

Eine Nachricht vollständig, mit der zitierten Nachricht und Reaktionen.

search_contacts

read

Kontakte nach Name oder Nummer finden.

get_contact

read

Name, Nummer, Info-Text, Profilbild.

get_group_info

read

Teilnehmer, Administratoren, Ankündigungsmodus, Einladungslink (wenn du Admin bist).

download_media

read

Speichert einen Anhang auf der Festplatte; kleine Bilder werden auch inline zurückgegeben.

send_message

write

Text senden, optional als Antwort, mit @-Erwähnungen.

send_media

write

Ein Bild, Video, Audio, Sprachnachricht oder Dokument von einem Pfad oder einer URL senden.

send_poll

write

Eine Umfrage mit 2–12 Optionen senden.

send_location

write

Einen Karten-Pin senden.

edit_message

write

Bearbeite deine eigene Nachricht innerhalb des 15-Minuten-Fensters von WhatsApp.

react_to_message

write

Eine Emoji-Reaktion hinzufügen oder entfernen.

forward_message

write

Eine Nachricht an einen anderen Chat weiterleiten.

delete_message

write

Ziehe deine eigene Nachricht innerhalb des 2-Tage-Fensters von WhatsApp zurück.

manage_chat

write

Archivieren, anheften, stummschalten (standardmäßig 8h), als gelesen/ungelesen markieren.

create_group

write

Eine Gruppe erstellen und Teilnehmer hinzufügen.

manage_group

write

Hinzufügen, entfernen, befördern, degradieren, verlassen, umbenennen, Einladungslinks.

Jede Nachricht wird mit einem nicht-leeren text zurückgegeben: Medien- und Systemnachrichten enthalten einen Platzhalter wie [image] caption, [voice message], [deleted] oder [poll] Pizza or pasta?. Zeitstempel sind ISO 8601 mit dem UTC-Offset der Maschine, zusammen mit einem menschlichen age wie 2h ago.

Skills

wazap enthält fünf Agent Skills, die einem Agenten die Arbeitsabläufe hinter den Tools beibringen, nicht nur die Tools:

Skill

Was der Agent tut

wazap-setup

Diagnose mit wazap status, Verknüpfung per QR- oder Pairing-Code, Client mit wazap connect verbinden, abgelaufene Sitzung reparieren

whatsapp-inbox

„Was habe ich verpasst?" Triage in braucht dich / zur Info / Rauschen, sortiert, plus vergessene Antworten. Nur lesen

whatsapp-recall

„Finde die Rechnung, die Dan geschickt hat." Suche mit Suchvarianten, blättere in der Zeit zurück, lade die Datei herunter und lies sie. Nur lesen

whatsapp-groups

Hole in einer 300-Nachrichten-Gruppe auf: Entscheidungen, Termine, was von dir verlangt wird. Nur lesen

whatsapp-send

Entwurf im eigenen Register des Chats, Empfänger und Text anzeigen, nur senden, nachdem der Benutzer ja gesagt hat

Installiere alles (Server und Skills) als Claude-Code-Plugin:

/plugin marketplace add razvangirgiz/wazap
/plugin install wazap@wazap

Oder kopiere skills/<name>/ in ein beliebiges Skills-Verzeichnis, das dein Agent liest.

Fehler

Jeder Fehler ist ein strukturiertes { error, message, fix } anstelle eines Stack-Trace, sodass ein Agent entscheiden kann, ob er es erneut versuchen, den Benutzer fragen oder aufhören soll.

Code

Bedeutung

NOT_LINKED

Kein Konto verknüpft. Führe npx wazap-mcp login aus.

SESSION_EXPIRED

Vom Telefon entkoppelt. Führe npx wazap-mcp login aus.

SESSION_CORRUPT

Anmeldedaten nicht lesbar. Führe npx wazap-mcp logout und dann login aus.

NOT_CONNECTED

Verbindet sich noch oder verbindet sich erneut.

SYNC_IN_PROGRESS

Die Verlaufssynchronisierung ist noch nicht abgeschlossen; Ergebnisse können unvollständig sein.

INVALID_PHONE

Die Nummer ist nicht im internationalen Format.

INVALID_ID

Keine WhatsApp-Chat-, Kontakt- oder Gruppen-ID.

NOT_ON_WHATSAPP

Diese Nummer hat kein WhatsApp-Konto.

CHAT_NOT_FOUND / MESSAGE_NOT_FOUND / CONTACT_NOT_FOUND / GROUP_NOT_FOUND

Unbekannte ID.

NOT_A_PARTICIPANT / NOT_ADMIN / GROUP_ANNOUNCEMENT_ONLY

Gruppenberechtigungen.

MEDIA_UNAVAILABLE

WhatsApp hat die Datei ablaufen lassen, oder sie wurde hier nie synchronisiert.

FILE_NOT_FOUND / FILE_TOO_LARGE / URL_FETCH_FAILED

Probleme mit ausgehenden Medien.

TEXT_TOO_LONG

Über WhatsApps Nachrichtenlimit.

EDIT_WINDOW_EXPIRED / RETRACT_WINDOW_EXPIRED / NOT_OWN_MESSAGE

WhatsApps eigene Grenzen beim Bearbeiten und Löschen.

READ_ONLY

wazap läuft im Nur-Lesen-Modus.

RATE_LIMITED

Zu viele Schreibvorgänge; fix sagt, wie lange du warten musst.

TIMEOUT / WHATSAPP_ERROR

WhatsApp hat nicht geantwortet oder die Operation abgelehnt.

Datenverzeichnis

Alles befindet sich in ~/.wazap (überschreibbar mit --data-dir oder WAZAP_DATA_DIR), erstellt mit 0700 und Anmeldedaten mit 0600 geschrieben:

~/.wazap/
  auth/         WhatsApp credentials — treat this like a password
  media/        downloads from download_media
  history/      per-chat message history, so a restart is not amnesia
  store.json    chat-list snapshot
  server.lock   pid of the running server
  daemon.json   loopback endpoint a second wazap bridges to
  .env          optional settings, see .env.example

Anmeldedaten werden in eine temporäre Datei geschrieben und dann an Ort und Stelle umbenannt, sodass ein Abbrechen des Prozesses während des Schreibens nicht dazu führen kann, dass du dein Telefon erneut verknüpfen musst.

Mehrere Clients gleichzeitig

{"type": "text"}

Claude Desktop, Claude Code und Cursor starten jeweils ihr eigenes wazap. WhatsApp erlaubt einen Socket pro verknüpftem Gerät, daher teilen sie sich eine Sitzung, statt darum zu kämpfen. Das erste wazap in einem Datenverzeichnis besitzt die Sitzung und öffnet einen MCP-Endpunkt auf 127.0.0.1; jedes weitere stellt über diesen Endpunkt eine Brücke zu ihm her. Es gibt nichts zu konfigurieren, und kein Client kann den Unterschied erkennen. Der Besitzer veröffentlicht <data-dir>/daemon.json (0600) mit seiner PID, seinem Port und dem Token, mit dem sich eine Brücke authentifiziert.

Eine Brücke bedient das, was der Besitzer bereitstellt, sodass ein mit --read-only gestarteter Besitzer jeden Client schreibgeschützt macht, unabhängig davon, mit welchen Flags dieser Client gestartet wurde.

Wenn der Besitzer beendet wird, beenden sich auch die Brücken mit ihm, und das nächste wazap, das ein Client startet, wird der neue Besitzer.

WAZAP_NO_SHARE=1 verzichtet darauf: Ein zweites wazap im selben Verzeichnis beendet sich mit Code 2 und nennt die PID des bereits laufenden. Ein explizites --http ist ein eigener Server statt einer Brücke und wird auf dieselbe Weise abgelehnt.

Schreibgeschützter Modus

Schreibvorgänge sind Opt-in. login fragt einmal nach und speichert die Antwort in <data-dir>/.env; wazap config writes on|off ändert sie, und wazap config allein gibt jede wirksame Einstellung samt ihrer Herkunft aus.

WAZAP_READ_ONLY=1 oder wazap serve --read-only registriert die Schreib-Tools gar nicht erst. Der Agent sieht sie nie und kann daher niemanden von Ihrer Nummer aus anschreiben, nicht einmal versehentlich – nützlich, wenn das verknüpfte Konto Ihr persönliches ist.

Schreibvorgänge sind außerdem auf WAZAP_RATE_LIMIT pro Minute begrenzt (Standard 20, 0 deaktiviert). Schneller zu senden, als ein Mensch es täte, ist ein Weg, wie Konten gesperrt werden.

HTTP-Modus

WAZAP_READ_TOKEN=$(openssl rand -hex 32) \
WAZAP_WRITE_TOKEN=$(openssl rand -hex 32) \
npx wazap-mcp serve --http --host 0.0.0.0 --port 8766

Streamable HTTP unter /mcp, mit einem Health-Check unter /healthz. Zwei Bearer-Tokens: Das Lese-Token erhält die Lese-Tools, das Schreib-Token schaltet zusätzlich die Schreib-Tools frei, sodass ein durchgesickertes Lese-Token niemals jemanden anschreiben kann. wazap weigert sich, eine Nicht-Loopback-Adresse ohne Lese-Token zu binden.

Selbst gehostet

Betreiben Sie wazap auf einem eigenen Server, wenn der Agent nicht auf Ihrem Laptop läuft: einem anderen Rechner, einem VPS, der Infrastruktur eines Kunden. Die Sitzung bleibt auf diesem Server; nichts läuft über einen Dritten.

Mit systemd

npm install -g wazap-mcp
sudo useradd --system --home /var/lib/wazap --create-home wazap
sudo -u wazap WAZAP_DATA_DIR=/var/lib/wazap wazap login --phone +15550100   # pairing code works over SSH
sudo -u wazap tee /var/lib/wazap/.env >/dev/null <<END
WAZAP_READ_TOKEN=$(openssl rand -hex 32)
WAZAP_WRITE_TOKEN=$(openssl rand -hex 32)
END
sudo curl -fsSL https://raw.githubusercontent.com/razvangirgiz/wazap/main/deploy/wazap.service -o /etc/systemd/system/wazap.service
sudo systemctl enable --now wazap
curl -s http://127.0.0.1:8766/healthz

Die Unit bindet nur Loopback. Setzen Sie TLS davor mit der zweizeiligen deploy/Caddyfile (caddy run --config deploy/Caddyfile nach dem Bearbeiten des Hostnamens) oder einem beliebigen Reverse-Proxy, und richten Sie den Client dann auf https://your-host/mcp mit Authorization: Bearer <Lese- oder Schreib-Token> aus.

Mit Docker

git clone https://github.com/razvangirgiz/wazap && cd wazap
printf 'WAZAP_READ_TOKEN=%s\nWAZAP_WRITE_TOKEN=%s\n' $(openssl rand -hex 32) $(openssl rand -hex 32) > .env
docker compose run --rm wazap login --phone +15550100   # once; the session lands in the wazap-data volume
docker compose up -d
curl -s http://127.0.0.1:8766/healthz

Der Container veröffentlicht 8766 nur auf Loopback; fügen Sie denselben TLS-Proxy davor hinzu. Ein Upgrade ist git pull && docker compose up -d --build; das Volume behält die Sitzung.

Welche Clients darauf zugreifen können

Claude Code, Claude Desktop, Cursor, Codex, VS Code und jeder Client mit einem Feld „MCP-URL + Header" verbinden sich mit dem Bearer-Token. claude.ai-Connectors erfordern OAuth statt eines statischen Tokens und können daher noch kein selbst gehostetes wazap verwenden. Behalten Sie das Lese-Token in Clients, die nur lesen müssen; geben Sie das Schreib-Token bewusst heraus.

Einstellungen

Variable

Standard

Bedeutung

WAZAP_DATA_DIR

~/.wazap

Wo alles gespeichert wird.

WAZAP_READ_ONLY

0

Die Schreib-Tools nicht registrieren.

WAZAP_SYNC_FULL_HISTORY

0

WhatsApp um eine vollständigere Verlaufssynchronisierung bitten.

WAZAP_PERSIST_HISTORY

1

Chats und Nachrichten über Neustarts hinweg behalten.

WAZAP_RATE_LIMIT

20

Schreib-Tool-Aufrufe pro Minute; 0 deaktiviert.

WAZAP_TRANSPORT

stdio

stdio oder http.

WAZAP_HOST / WAZAP_PORT

127.0.0.1 / 8766

HTTP-Bind-Adresse.

WAZAP_READ_TOKEN / WAZAP_WRITE_TOKEN

nicht gesetzt

HTTP-Bearer-Tokens.

WAZAP_NO_UPDATE_CHECK

0

1 verhindert, dass status npm nach einer neueren Version fragt.

Flags schlagen Umgebungsvariablen, die wiederum <data-dir>/.env schlagen.

Bekannte Einschränkungen

  • Inoffiziell. Baileys hat das WhatsApp-Multi-Geräte-Protokoll per Reverse Engineering erschlossen. Dies ist nicht die WhatsApp Business API, und Meta unterstützt es nicht.

  • Sperrrisiko ist real. Automatisiertes Senden, Massen-Nachrichten oder alles, was ein Mensch nicht plausibel tippen würde, kann zur Sperrung der Nummer führen, und das ist von hier aus nicht rückgängig zu machen. Die Ratenbegrenzung hilft; sie ist keine Garantie.

  • Medienschlüssel laufen ab. WhatsApp entfernt alte Anhänge von seinen Servern, daher gibt download_media bei einer alten Nachricht MEDIA_UNAVAILABLE zurück.

  • Der Verlauf ist das, was das Telefon synchronisiert. wazap sieht den Verlauf, den WhatsApp dem verknüpften Gerät übergibt, nicht Ihr vollständiges Telefonarchiv. read_messages mit before fragt nach mehr, innerhalb dessen, was WhatsApp noch aufbewahrt.

  • @lid-IDs. Neuere Konten werden über eine Datenschutz-ID statt einer Telefonnummer adressiert. wazap übersetzt sie zurück in Telefonnummern, wenn es die Zuordnung gelernt hat, und reicht die @lid durch, wenn nicht.

  • Ihr Telefon muss erreichbar bleiben. Ein verknüpftes Gerät empfängt nicht mehr, sobald das Telefon lange genug offline war; get_status sagt das in hint.

Entwicklung

npm install
npm run typecheck
npm test                       # builds, then runs node --test
node test/smoke-stdio.mjs      # drives the built binary over MCP stdio
npm run dev -- status          # run from source with tsx

npm test benötigt keine WhatsApp-Sitzung. Der Stdio-Smoke-Test startet die gebaute Binärdatei mit einem Wegwerf-Datenverzeichnis und prüft, ob eine nicht verknüpfte Installation weiterhin initialize, tools/list und get_status beantwortet.

MIT-lizenziert.

Available Tools

23 tools
catch_upCatch up on what the user missedA
Read-only

What the user missed, all accounts, within budget_tokens: waiting (every open ask of 14 days, whatever the window), mentions, calls, people, groups, stories. account_id narrows it to one account; get_status names them. The mark moves first; a lost answer is since: "previous". more.cursor: the rest.

Inputs: ids, hours, since, cursor, +3 more. Returns: more, notes, direct, footer, +9 more

confirm_sendSend a drafted WhatsApp messageA
Idempotent

Send a draft the user approved — this text, this recipient: the only call that sends, once per draft. A yes about something else: show the preview again and ask. Expired, missing or stale: draft again, show the new preview, ask again. SEND_OUTCOME_UNKNOWN: read_messages, never redo it unasked.

Inputs: draft_id (required), account_id.

delete_messageDelete a WhatsApp messageA
DestructiveIdempotent

Delete a message; confirm with the user first. for_everyone: true retracts it for everyone within 2 days: the account's own message, or anyone's in a group where it is admin. for_everyone: false removes any message from the linked account's devices only.

Inputs: message_id (required), for_everyone (required), account_id. Returns: account_id, message_id, for_everyone

edit_messageEdit a WhatsApp message you sentA
DestructiveIdempotent

Replace the text of a message the linked account sent. WhatsApp allows it for 15 minutes after sending; later, send a correction instead.

Inputs: text (required), message_id (required), account_id. Returns: text, chat_id, timestamp, account_id, +1 more

find_contactFind who the user meansA
Read-onlyIdempotent

Who a name, nickname, relationship ("mama"), filed detail ("AP-123"), group, number or id means, before drafting. resolved: contact.chat_id, with number, note, tags, details and, when writing, context. ambiguous or not_found: ask the user; never guess. Several accounts: see fix. tag: its people.

Inputs: tag, kind, name, limit, +3 more. Returns: fix, next, notes, query, +11 more

get_group_infoGet WhatsApp group infoA
Read-onlyIdempotent

A group's name, description, owner and participants (up to 500), whether the account is admin, its settings (info_locked, member_add_mode, join_approval, disappearing_seconds), its community, and the invite link for an admin. Call it before manage_group.

Inputs: group_id (required), account_id. Returns: name, owner, chat_id, community, +12 more

get_mediaGet the media of a WhatsApp messageB
Read-only

What a message's media holds: a voice note or audio as its transcript (kept once made; an API provider bills it); a photo or sticker as an image; a video as a sheet of frames; a document as its text and first page. A local call also saves the file (save_to). MEDIA_UNAVAILABLE: gone.

Inputs: pages, detail, save_to, language, +3 more. Returns: link, mime, path, size, +18 more

get_messageGet one WhatsApp message in fullB
Read-onlyIdempotent

One message in full, its words never cut: the message it quotes, each reaction with who left it, poll votes and event answers by person, its media, and on the user's own messages who it reached and who read it.

Inputs: message_id (required), account_id. Returns: text, chat_id, timestamp, account_id, +1 more

get_statusGet the WhatsApp connection statusA
Read-onlyIdempotent

Whether the account works: status (connected, not_linked, linking with its pairing code…), sync, how fresh the history is, webhook delivery, versions. accounts lists every account, with default. Call it on NOT_CONNECTED, NOT_LINKED or SYNC_IN_PROGRESS.

Inputs: account_id, include_picture.

learnLearn how to use the WhatsApp toolsA
Read-onlyIdempotent

The guide, one topic at a time: ids (formats, several accounts, the message shape), workflows, errors (what to do about each code), or all. Call it when unsure about ids, several accounts or an error code; with no topic it lists the topics. Never touches WhatsApp.

Inputs: topic, account_id.

list_chatsList WhatsApp chatsB
Read-onlyIdempotent

Conversations, most recently active first: chat_id, name, type, unread count, last message, and whether archived, pinned, muted or left. Use it to find a chat_id.

Inputs: tag, limit, cursor, filter, +2 more. Returns: tag, sync, chats, count, +3 more

list_contactsList the phone's address bookA
Read-onlyIdempotent

The phone's address book on one account, a page at a time: saved name, phone (E.164), chat_id, contact_id, and when the last direct message was and its direction. No message words; #private people left out. address_book_synced false: not arrived yet.

Inputs: limit, order, cursor, account_id.

manage_chatManage a WhatsApp chatA
Destructive

Preview archive, pin, mute, pin_message, star_message, clear, delete, block and undo. After approval repeat chat_id/action with confirmation_id, without options. Expires in 15m; one attempt. mark_read runs directly, only when the user asks.

Inputs: action (required), chat_id (required), pin_hours, account_id, +3 more.

manage_groupManage a WhatsApp groupA
Destructive

Create a group, join one from an invite (preview first, then confirm: true), or administer one: members, name, description, photo, invite link, join requests, settings, leave. Most actions need admin. Every change shows to all members at once: say what will change, wait for a yes.

Inputs: action (required), url, value, invite, +6 more. Returns: name, next, action, status, +10 more

react_to_messageReact to a WhatsApp messageA
Idempotent

React to a message with one emoji, or pass "" to take your reaction off.

Inputs: emoji (required), message_id (required), account_id. Returns: emoji, account_id, message_id

read_messagesRead messages from a WhatsApp chatA
Read-onlyIdempotent

Read one chat, oldest to newest: the latest messages, older ones with before (wazap asks the phone when the local history runs out), or a window with since/until. Long texts are cut unless full_text. chat_id "status": the stories of the last hours (a day at most), shown nowhere else.

Inputs: chat_id (required), hours, limit, since, +6 more. Returns: sync, count, hours, notes, +13 more

rememberRemember something about a personA
Idempotent

Keep what the user says about someone, locally, never on WhatsApp: a note, tags, details find_contact matches ({"relatie": "mama"}), or handled: true for an ask dealt with elsewhere. #private keeps their words out of what you did not ask about them by name; #no-catchup keeps them out of catch_up.

Inputs: chat_id (required), note, fields, handled, +4 more. Returns: name, note, tags, fields, +7 more

reminderSet, list or cancel a reminder about a chatA

The user's reminders about a chat, kept locally and posted to their webhook when due: create (chat_id, note, after_hours or due_at); condition "no_reply" fires only if nobody wrote there since ("if Ana has not answered in 2 days"). list, cancel. Nothing goes to WhatsApp.

Inputs: note, limit, action, due_at, +7 more. Returns: count, notes, action, cancelled, +2 more

scheduled_messagesList or cancel scheduled WhatsApp messagesA
Idempotent

The account's scheduled messages: list (waiting ones soonest first, then the week's sent, missed, failed and cancelled ones) or cancel one by schedule_id before it goes. To schedule one, send_message with send_at, then confirm_send. Tell the user about every missed or failed one.

Inputs: limit, action, account_id, schedule_id, +1 more. Returns: count, action, cancelled, scheduled, +1 more

send_messageDraft a WhatsApp messageA

Drafts text, media, polls, locations, forwards; sends nothing. Call it as soon as you have recipient and text: it returns draft_id and preview (recipient, number, exact text). Show that preview; confirm_send only on a yes to this text and recipient — a send in the same request is that yes.

Inputs: text (required), chat_id (required), as, url, +15 more.

wait_for_messagesWait for new WhatsApp messagesA
Read-onlyIdempotent

Wait for messages from other people, up to timeout_seconds, and return them with a cursor: pass it to the next call so nothing that lands between calls is missed. addressed_to_me wakes only for direct messages, mentions and replies to the user. For agents that stay on the line.

Inputs: cursor, chat_id, account_id, addressed_to_me, +1 more. Returns: count, cursor, messages, timed_out, +2 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 23 tools

    Disambiguation4/5

    Most tools map to a distinct resource+action, and the descriptions actively separate the message-reading cluster (read_messages, get_message, catch_up, wait_for_messages, search) by scenario. The draft/confirm_send split and the manage_chat vs manage_group overlap are the only places where an agent could hesitate, but both are explicitly clarified.

    Naming Consistency3/5

    The dominant pattern is verb_noun (list_chats, get_message, delete_message, manage_group), but several tools break it: bare verbs (learn, remember, search, catch_up) and bare nouns (scheduled_messages, reminder). The convention is readable but mixed enough to be noted.

    Tool Count4/5

    23 tools is on the heavy side, but the server spans multiple accounts, chats, groups, media, drafts, scheduling and reminders, so each tool covers a distinct slice rather than duplicating scope. It is at the upper edge of well-scoped rather than bloated.

    Completeness4/5

    The surface covers the full message lifecycle (draft, confirm, edit, delete, react), reading/search/triage, contacts, groups, media, scheduling, account linking/status and local reminders. Only minor gaps remain, such as profile/settings management and a standalone read-marking call outside manage_chat.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      WhatsApp MCP server that exposes messaging, groups, contacts, and profile management as tools and resources for AI agents, supporting Baileys and Meta Cloud API.
      29
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A self-hosted WhatsApp bridge that exposes a stdio MCP server with ~20 tools for reading conversations, sending messages, managing groups, contacts, and aliases, enabling AI agents to operate WhatsApp directly.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that connects AI agents to WhatsApp using the multi-device API, enabling messaging, group management, and more as a regular user.
      6 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A native MCP server for SocialMate that gives your AI a WhatsApp, enabling it to send and read messages, manage contacts and groups, and more through 44 tools.
      46 npm
      1
      MIT