waxum-mcp
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 |
| Sendet eine Textnachricht |
| Sendet eine lokale Datei (Bild/Video/Audio/Dokument/Sticker), Typ wird automatisch aus dem Mimetype erkannt |
| Liest den letzten Verlauf eines Chats oder durchsucht ihn nach Stichwort – inklusive Absender-push_name und Medienverweisen |
| Lädt die Medien einer Nachricht auf die lokale Festplatte herunter, gibt den Dateipfad zurück |
| Listet Gruppen auf, in denen diese Session ist, mit JIDs und Mitgliedern |
| Listet/durchsucht bekannte Kontakte nach Name, Telefon oder push_name |
| 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 ./mediaSpawn-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 # optionalIm 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 buildThis server cannot be installed
Maintenance
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
- AlicenseBqualityCmaintenanceAn 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.285MIT
- AlicenseNot gradedqualityBmaintenanceA WhatsApp Web MCP server that enables reading chats, contacts, and messages, as well as sending, replying, reacting, and managing WhatsApp messages via stdio.653MIT
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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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