Skip to main content
Glama
waxum-mcp

waxum-mcp

by imtaqin

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)、その後このサーバーをそのペアリング済みセッションに向けてください。

ツール

ツール

機能

send_message

テキストメッセージを送信

send_file

ローカルファイル(画像/動画/音声/ドキュメント/ステッカー)を送信。種類は mimetype から自動検出

get_messages

チャットの最近の履歴を読む、またはキーワードで検索。送信者の push_name とメディアポインタを含む

download_media

メッセージのメディアをローカルディスクにダウンロードし、ファイルパスを返す

list_groups

このセッションが参加しているグループを JID とメンバーとともに一覧表示

list_chats

名前、電話番号、または push_name で既知の連絡先を一覧表示/検索

session_status

接続/ログイン状態を確認

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 build

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    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.
      4
      28
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      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.
      28 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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 npm
      MIT