Servidor MCP para WhatsApp, respaldado por la pasarela de API REST waxum. Expone herramientas de envío/lectura/medios a cualquier cliente MCP (Claude Desktop, Claude Code, etc.) a través de stdio.
Requiere waxum >= 0.11.5 (necesita GET /messages/chat/{chat_jid}).
El emparejamiento de sesión (vinculación por QR / número de teléfono) no forma parte de este servidor: empareja la sesión directamente contra waxum primero (su propia consola o POST /sessions/{id}/pair), y luego apunta este servidor a esa sesión ya emparejada.
Herramienta | Descripción |
| Envía un mensaje de texto |
| Envía un archivo local (imagen/video/audio/documento/sticker), tipo auto-detectado por mimetype |
| Lee el historial reciente de un chat, o lo busca por palabra clave — incluye push_name del remitente y punteros a medios |
| Descarga el medio de un mensaje al disco local, devuelve la ruta del archivo |
| Lista los grupos en los que está esta sesión, con JIDs y miembros |
| Lista/busca contactos conocidos por nombre, teléfono o push_name |
| Comprueba el estado de conexión/inicio de sesión |
Related MCP server: wappmcp
Dos formas de apuntar este servidor a waxum, elegidas por WAXUM_MODE (o auto-detectadas: client si WAXUM_BASE_URL está definido, si no spawn).
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 ./mediaWAXUM_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 # optionalEn el modo spawn, el token se convierte en la variable de entorno SUPERADMIN_TOKEN del proceso generado — la credencial de arranque propia de waxum — por lo que no es necesario acuñar ningún token de antemano. La salida estándar y el error estándar del proceso hijo se reenvían al error estándar de este servidor (nunca a la salida estándar, que está reservada para el canal de protocolo MCP).
El modo spawn usa SQLite por defecto en <WAXUM_WORKDIR>/waxum.db, manteniendo el servidor MCP sin configuración y seguro ante reinicios. Establece WAXUM_DATABASE_URL a una ruta sqlite:// explícita, una URL de PostgreSQL o una URL de MySQL cuando sea necesario.
npm install
npm run dev # run directly with tsx
npm run build # compile to dist/
npm start # run the compiled buildThis server cannot be deployed
Your own WhatsApp as an MCP server: read, search and send from any MCP client.
Drive WhatsApp from any MCP client: pair devices, send text and media, manage contacts and groups.
Free WhatsApp MCP server for ChatGPT and Claude: read and search chats, every send you approve.
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
