MCP-сервер для WhatsApp, работающий на основе REST API-шлюза waxum. Предоставляет инструменты отправки/чтения/медиа любому MCP-клиенту (Claude Desktop, Claude Code и т.д.) через stdio.
Требуется waxum >= 0.11.5 (нужен GET /messages/chat/{chat_jid}).
Сопряжение сессии (QR / привязка по номеру телефона) не является частью этого сервера — сначала выполните сопряжение сессии напрямую с waxum (через его собственную консоль или POST /sessions/{id}/pair), затем укажите этому серверу на уже сопряжённую сессию.
Tool | Does |
| Отправить текстовое сообщение |
| Отправить локальный файл (изображение/видео/аудио/документ/стикер), тип определяется автоматически по mimetype |
| Прочитать недавнюю историю чата или выполнить поиск по ключевому слову — включает push_name отправителя и указатели на медиа |
| Скачать медиа сообщения на локальный диск, возвращает путь к файлу |
| Список групп, в которых состоит эта сессия, с JID и участниками |
| Список/поиск известных контактов по имени, телефону или push_name |
| Проверить статус подключения/входа |
Related MCP server: wappmcp
Два способа указать этому серверу на waxum, выбирается с помощью WAXUM_MODE (или автоматически: client, если задан WAXUM_BASE_URL, иначе 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 # optionalВ режиме spawn токен становится переменной окружения SUPERADMIN_TOKEN запущенного процесса — собственным начальным учётным данным waxum — поэтому токен не нужно создавать заранее. Стандартный вывод и поток ошибок дочернего процесса перенаправляются в поток ошибок этого сервера (никогда в стандартный вывод, который зарезервирован для канала протокола MCP).
Режим spawn по умолчанию использует SQLite по адресу <WAXUM_WORKDIR>/waxum.db, что делает MCP-сервер не требующим настройки и безопасным при перезапуске. При необходимости задайте WAXUM_DATABASE_URL как явный путь sqlite://, URL PostgreSQL или URL MySQL.
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.
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.
WhatsApp (Web + Business API), SMS, contacts, and call records via 2Chat's MCP server.
