Skip to main content
Glama
imtaqin

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: mcp-wacli

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
F
license - not found
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

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.
    28
    5
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    An MCP server that wraps the wacli tool to enable AI clients to read, search, and send WhatsApp messages through a personal account. It provides comprehensive tools for managing chats, groups, and contacts using an existing authenticated WhatsApp session.
    27
  • F
    license
    Not graded
    quality
    Not graded
    maintenance
    A self-hosted MCP server that connects AI clients to WhatsApp via the WAHA HTTP API. It enables users to manage sessions, search contacts, and send or receive messages and media directly through natural language interfaces.
    21
  • A
    license
    Not graded
    quality
    B
    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.
    65
    3
    MIT

View all related MCP servers

Related MCP Connectors

  • Hosted MCP server for the Wavix telecom platform: SMS, voice, 2FA, SIP, numbers, 10DLC, CDRs.

  • Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.

  • MCP server for Gainium — manage trading bots, deals, and balances via AI assistants

View all MCP Connectors

Latest Blog Posts

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/imtaqin/waxum-mcp'

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