waxum-mcp
waxum-mcp
WhatsApp 用の MCP サーバーで、waxum REST API ゲートウェイをバックエンドとしています。stdio 経由で任意の MCP クライアント(Claude Desktop、Claude Code など)に送信・読み取り・メディアのツールを公開します。
waxum >= 0.11.5 が必要です(GET /messages/chat/{chat_jid} が必要)。
セッションペアリング(QR / 電話番号リンク)はこのサーバーの対象外です。
先に waxum に対して直接セッションをペアリングし(独自コンソールまたは
POST /sessions/{id}/pair)、その後このサーバーをそのペアリング済みセッションに向けてください。
ツール
ツール | 機能 |
| テキストメッセージを送信 |
| ローカルファイル(画像/動画/音声/ドキュメント/ステッカー)を送信。種類は mimetype から自動検出 |
| チャットの最近の履歴を読む、またはキーワードで検索。送信者の push_name とメディアポインタを含む |
| メッセージのメディアをローカルディスクにダウンロードし、ファイルパスを返す |
| このセッションが参加しているグループを JID とメンバーとともに一覧表示 |
| 名前、電話番号、または push_name で既知の連絡先を一覧表示/検索 |
| 接続/ログイン状態を確認 |
Related MCP server: wappmcp
設定
このサーバーを waxum に向ける方法は 2 つあり、WAXUM_MODE で選択します(または
自動検出: WAXUM_BASE_URL が設定されている場合は client、それ以外は spawn)。
クライアントモード — waxum が別の場所で既に実行されている
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スポーンモード — このサーバーが waxum プロセスを管理する
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スポーンモードでは、トークンは生成されたプロセスの
SUPERADMIN_TOKEN 環境変数になります — waxum 自身のブートストラップ資格情報です — そのため、
事前にトークンを発行する必要はありません。子プロセスの stdout
と stderr はこのサーバーの stderr に転送されます(MCP プロトコルチャネル用に予約されている stdout には決して送られません)。
スポーンモードはデフォルトで <WAXUM_WORKDIR>/waxum.db の SQLite を使用し、
MCP サーバーをゼロ設定で再起動安全に保ちます。必要に応じて WAXUM_DATABASE_URL を
明示的な sqlite:// パス、PostgreSQL URL、または MySQL URL に設定してください。
開発
npm install
npm run dev # run directly with tsx
npm run build # compile to dist/
npm start # run the compiled buildTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Your own WhatsApp as an MCP server: read, search and send from any MCP client.
Hosted WhatsApp MCP server: read, search and reply to your own WhatsApp chats from your AI.
Drive WhatsApp from any MCP client: pair devices, send text and media, manage contacts and groups.
Hosted WhatsApp MCP server: send and read messages from your own linked number. OAuth sign-in.
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.4285MIT
- AlicenseNot gradedqualityDmaintenanceA WhatsApp Web MCP server that enables reading chats, contacts, and messages, as well as sending, replying, reacting, and managing WhatsApp messages via stdio.28 npm3MIT
- AlicenseNot gradedqualityDmaintenanceA 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 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP 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 npmMIT