Skip to main content
Glama
waxum-mcp

waxum-mcp

by imtaqin

waxum-mcp

MCP-Server für WhatsApp, basierend auf dem waxum REST-API-Gateway. Stellt jedem MCP-Client (Claude Desktop, Claude Code usw.) über stdio Sende-/Lese-/Medien-Tools bereit.

Erfordert waxum >= 0.11.5 (benötigt GET /messages/chat/{chat_jid}).

Session-Pairing (QR / Telefonnummer-Verknüpfung) ist nicht Teil dieses Servers – pair die Session zuerst direkt gegen waxum (dessen eigene Konsole oder POST /sessions/{id}/pair) und richte diesen Server dann auf diese bereits gepairte Session aus.

Tools

Tool

Funktion

send_message

Sendet eine Textnachricht

send_file

Sendet eine lokale Datei (Bild/Video/Audio/Dokument/Sticker), Typ wird automatisch aus dem Mimetype erkannt

get_messages

Liest den letzten Verlauf eines Chats oder durchsucht ihn nach Stichwort – inklusive Absender-push_name und Medienverweisen

download_media

Lädt die Medien einer Nachricht auf die lokale Festplatte herunter, gibt den Dateipfad zurück

list_groups

Listet Gruppen auf, in denen diese Session ist, mit JIDs und Mitgliedern

list_chats

Listet/durchsucht bekannte Kontakte nach Name, Telefon oder push_name

session_status

Prüft Verbindungs-/Anmeldestatus

Related MCP server: wappmcp

Konfiguration

Zwei Möglichkeiten, diesen Server auf waxum auszurichten, gewählt über WAXUM_MODE (oder automatisch erkannt: client, wenn WAXUM_BASE_URL gesetzt ist, sonst spawn).

Client-Modus – waxum läuft bereits woanders

WAXUM_MODE=client
WAXUM_BASE_URL=http://localhost:3451
WAXUM_TOKEN=<superadmin token or a session token>
WAXUM_SESSION_ID=<the session to operate on>
WAXUM_MEDIA_DIR=./media   # optional, default ./media

Spawn-Modus – dieser Server verwaltet den waxum-Prozess

WAXUM_MODE=spawn
WAXUM_BINARY_PATH=/path/to/waxum
WAXUM_WORKDIR=/path/to/waxum/data   # optional, default: binary's directory
WAXUM_PORT=3451                     # optional, default 3451
WAXUM_TOKEN=<superadmin token>      # optional, a random one is generated if unset
WAXUM_SESSION_ID=<the session to operate on>
WAXUM_DATABASE_URL=sqlite:///data/waxum.db # optional

Im Spawn-Modus wird das Token zur SUPERADMIN_TOKEN-Umgebungsvariable des gestarteten Prozesses – waxums eigene Bootstrap-Anmeldeinformation – sodass kein Token im Voraus erstellt werden muss. Die Standardausgabe und Standardfehlerausgabe des Kindprozesses werden an die Standardfehlerausgabe dieses Servers weitergeleitet (niemals an die Standardausgabe, die für den MCP-Protokollkanal reserviert ist).

Der Spawn-Modus verwendet standardmäßig SQLite unter <WAXUM_WORKDIR>/waxum.db, was den MCP-Server ohne Konfiguration und Neustart-sicher hält. Setze WAXUM_DATABASE_URL auf einen expliziten sqlite://-Pfad, eine PostgreSQL-URL oder eine MySQL-URL, wenn nötig.

Entwicklung

npm install
npm run dev     # run directly with tsx
npm run build   # compile to dist/
npm start       # run the compiled build

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      An MCP server that enables interaction with WhatsApp using the Baileys library and Streamable HTTP transport. It supports managing contacts, chats, and messages, while providing a web admin UI for QR code authentication and media handling.
      4
      28
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A WhatsApp Web MCP server that enables reading chats, contacts, and messages, as well as sending, replying, reacting, and managing WhatsApp messages via stdio.
      28 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A least-privilege, send-only MCP server for WhatsApp, backed by Meta's official WhatsApp Cloud API. It exposes tools to send text messages and pre-approved templates.
      8 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that turns WhatsApp into agent-callable tools, enabling search contacts, send/receive messages, read chats, handle media, and monitor calls via the WhatsApp Web multi-device protocol.
      11 npm
      MIT