Skip to main content
Glama
wazap-mcp

wazap-mcp

by razvangirgiz
██╗    ██╗ █████╗ ███████╗ █████╗ ██████╗
██║    ██║██╔══██╗╚══███╔╝██╔══██╗██╔══██╗
██║ █╗ ██║███████║  ███╔╝ ███████║██████╔╝
██║███╗██║██╔══██║ ███╔╝  ██╔══██║██╔═══╝
╚███╔███╔╝██║  ██║███████╗██║  ██║██║
 ╚══╝╚══╝ ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝

あなたのAIエージェントのためのWhatsApp。 WhatsAppアカウント(チャット、メッセージ、メディア、連絡先、グループ)を、任意のMCPクライアントが呼び出せる22のツールの背後に置くMCPサーバーです。ペアリングコードによるログイン、ブラウザ不要、電話番号の再販業者なし、RAM約20MB。

Baileys 上に構築されており、これはWebSocket上でWhatsAppのマルチデバイスプロトコルを話します。

はじめに

npmパッケージは wazap-mcp で、インストールされるコマンドは wazap です。

npx wazap-mcp setup

それがインストールのすべてです。アカウントをリンクし、このマシンにインストールされているMCPクライアントを検出して、それらの設定を書き込み、何を再起動すべきかを教えてくれます。

または、エージェントにやってもらいましょう。これを貼り付けてください:

WhatsAppをセットアップして:npx wazap-mcp setup --agent を実行して、表示される指示に従ってください。

そしてエージェントにこう尋ねます:「今日のWhatsAppで何を見逃した?」

以下は setup が実行する手順です。手動で実行したい場合、それぞれ独立したコマンドとしても使用できます。

npx wazap-mcp login はQRコードを表示します。設定 → リンク済みデバイス → デバイスをリンク からスキャンしてください。カメラが手元にない、またはSSH経由でリンクする場合は? npx wazap-mcp login --phone +15550100 は、代わりに電話番号でリンク の下に入力する8文字のコードを表示します。最後に、エージェントがメッセージを送信してよいかどうかを尋ねられます。あなたが「はい」と言わない限り答えは「いいえ」で、後で npx wazap-mcp config writes on で変更できます。

npx wazap-mcp connect claude-code は、1つのクライアントのMCPエントリを書き込みます。残りは クライアントを接続 の下の表にあります。

npx wazap-mcp 単体は実行しても安全です。現在の状態と次に何をすべきかを表示し、サーバーは起動しません。何か問題がある場合、npx wazap-mcp status を最初に実行してください。Node、データディレクトリ、ロック、認証情報、新しいバージョンが出ているかどうかを確認し、壊れているものの隣に修正方法を表示します。

クライアントを接続

wazap connect <client> は、ファイル内の他の内容を保持し、最初の変更の前に一度バックアップして、エントリを書き込みます。--dry-run は書き込む内容を表示します。

クライアント

connect が書き込む内容

claude-code

claude mcp add whatsapp を実行します

claude-desktop

Claudeアプリケーションディレクトリ内の claude_desktop_config.json

cursor

~/.cursor/mcp.json

codex

~/.codex/config.toml 内の [mcp_servers.whatsapp]

vscode

現在のワークスペース用の ./.vscode/mcp.json

gemini

~/.gemini/settings.json

リモートクライアント

クライアントのMCP URLフィールド:ヘッダー Authorization: Bearer <token> 付きの https://your-host/mcp(セルフホスト を参照)

どのMCPクライアントでも同じように動作します。コマンドは npx -y wazap-mcp、トランスポートは stdio です。エージェントに最初に learn を呼び出すように伝えてください。ID形式、ワークフロー、すべてのエラーコードとその対処法が返されます。

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "wazap-mcp"]
    }
  }
}

Claude Desktop、Cursor、Gemini CLIはまさにそれを受け入れます。VS Codeはそれを servers の下にネストし、command の横に "type": "stdio" を必要とします。Codex CLIはTOMLです:

[mcp_servers.whatsapp]
command = "npx"
args = ["-y", "wazap-mcp"]

skills/ フォルダーは Agent Skills 形式に従っているため、Codex、Cursor、その他のスキル対応エージェントは同じ5つのスキルを読み込めます。

Related MCP server: wa-bridge

ツール

ツール

種別

説明

learn

読み取り

すべてのツール、ID形式、エラーコードのガイド。最初に呼び出してください。

get_status

読み取り

接続ステータス、同期状態、リンクされたアカウント、バージョン、データディレクトリ。

list_chats

読み取り

会話を新しい順に表示。all/unread/groups/individual/archived でフィルタリング。

read_messages

読み取り

チャット内のメッセージ。before でさらに過去のページに移動し、電話から古い履歴を取得します。

get_recent_messages

読み取り

過去N時間のすべてをチャットごとにグループ化。追いつき用ツール。

search_messages

読み取り

ローカルに保持されているメッセージ全体のテキスト検索。

get_message

読み取り

1つのメッセージを、引用メッセージとリアクション付きで完全に取得。

search_contacts

読み取り

名前または番号で連絡先を検索。

get_contact

読み取り

名前、番号、紹介文、プロフィール写真。

get_group_info

読み取り

参加者、管理者、アナウンスモード、招待リンク(自分が管理者の場合)。

download_media

読み取り

添付ファイルをディスクに保存。小さい画像はインラインでも返されます。

send_message

書き込み

テキストを送信。返信として、@メンション付きでも送信可能。

send_media

書き込み

画像、ビデオ、音声、ボイスメモ、ドキュメントをパスまたはURLから送信。

send_poll

書き込み

2〜12の選択肢で投票を送信。

send_location

書き込み

地図のピンを送信。

edit_message

書き込み

自分のメッセージを編集。WhatsAppの15分以内の制限内。

react_to_message

書き込み

絵文字リアクションを追加または削除。

forward_message

書き込み

メッセージを別のチャットに転送。

delete_message

書き込み

自分のメッセージを取り消し。WhatsAppの2日以内の制限内。

manage_chat

書き込み

アーカイブ、ピン留め、ミュート(デフォルト8時間)、既読/未読のマーク。

create_group

書き込み

グループを作成し、参加者を追加。

manage_group

書き込み

追加、削除、昇格、降格、退出、名前変更、招待リンク。

すべてのメッセージには空でない text が付いて返されます。メディアやシステムメッセージには、[image] caption、[voice message]、[deleted]、[poll] Pizza or pasta? のようなプレースホルダーが含まれます。タイムスタンプはマシンのUTCオフセット付きのISO 8601形式で、2h ago のような人間向けの age も併記されます。

スキル

wazapには、ツールだけでなくその背後にあるワークフローをエージェントに教える5つの Agent Skills が同梱されています:

スキル

エージェントが行うこと

wazap-setup

wazap status で診断し、QRコードまたはペアリングコードでリンクし、wazap connect でクライアントを接続し、期限切れセッションを修復する

whatsapp-inbox

「何を見逃した?」 あなたの対応が必要 / 参考情報 / ノイズ にトリアージして順位付けし、忘れられた返信も表示。読み取り専用

whatsapp-recall

「Danが送った請求書を見つけて。」クエリのバリエーションで検索し、時間をさかのぼってページングし、ファイルをダウンロードして読む。読み取り専用

whatsapp-groups

300メッセージのグループに追いつく:決定事項、日付、あなたに求められていること。読み取り専用

whatsapp-send

チャットの固有の文体で下書きし、受信者とテキストを表示し、ユーザーが「はい」と言った場合にのみ送信する

すべて(サーバーとスキル)をClaude Codeプラグインとしてインストール:

/plugin marketplace add razvangirgiz/wazap
/plugin install wazap@wazap

または、skills/<name>/ をエージェントが読み取る任意のスキルディレクトリにコピーします。

エラー

すべての失敗はスタックトレースではなく、構造化された { error, message, fix } として返されます。そのためエージェントは、再試行するか、ユーザーに尋ねるか、停止するかを判断できます。

コード

意味

NOT_LINKED

アカウントがリンクされていません。npx wazap-mcp login を実行してください。

SESSION_EXPIRED

電話からリンクが解除されました。npx wazap-mcp login を実行してください。

SESSION_CORRUPT

認証情報を読み取れません。npx wazap-mcp logout を実行してから login を実行してください。

NOT_CONNECTED

まだ接続中または再接続中です。

SYNC_IN_PROGRESS

履歴の同期が完了していません。結果が部分的になる可能性があります。

INVALID_PHONE

番号が国際形式ではありません。

INVALID_ID

WhatsAppのチャット、連絡先、グループIDのいずれでもありません。

NOT_ON_WHATSAPP

その番号にはWhatsAppアカウントがありません。

CHAT_NOT_FOUND / MESSAGE_NOT_FOUND / CONTACT_NOT_FOUND / GROUP_NOT_FOUND

不明なIDです。

NOT_A_PARTICIPANT / NOT_ADMIN / GROUP_ANNOUNCEMENT_ONLY

グループの権限。

MEDIA_UNAVAILABLE

WhatsAppがファイルを期限切れにしたか、ここで一度も同期されていません。

FILE_NOT_FOUND / FILE_TOO_LARGE / URL_FETCH_FAILED

送信メディアの問題。

TEXT_TOO_LONG

WhatsAppのメッセージ上限を超えています。

EDIT_WINDOW_EXPIRED / RETRACT_WINDOW_EXPIRED / NOT_OWN_MESSAGE

編集と削除に関するWhatsApp独自の制限。

READ_ONLY

wazapは読み取り専用で実行されています。

RATE_LIMITED

書き込みが多すぎます。fix に待つ時間が示されています。

TIMEOUT / WHATSAPP_ERROR

WhatsAppが応答しないか、操作を拒否しました。

データディレクトリ

すべては ~/.wazap に置かれます(--data-dir または WAZAP_DATA_DIR で上書き可能)。ディレクトリは 0700 で作成され、認証情報は 0600 で書き込まれます:

~/.wazap/
  auth/         WhatsApp credentials — treat this like a password
  media/        downloads from download_media
  history/      per-chat message history, so a restart is not amnesia
  store.json    chat-list snapshot
  server.lock   pid of the running server
  daemon.json   loopback endpoint a second wazap bridges to
  .env          optional settings, see .env.example

認証情報の書き込みは一時ファイルに行われ、リネームで所定の場所に配置されます。そのため、書き込み途中でプロセスを強制終了しても、電話の再リンクが必要になることはありません。

複数のクライアントを同時に

Claude Desktop、Claude Code、Cursorはそれぞれ独自のwazapを起動します。WhatsAppはリンク済みデバイスごとに1つのソケットしか許可しないため、競合するのではなく1つのセッションを共有します。データディレクトリ上の最初のwazapがセッションを所有し、127.0.0.1上にMCPエンドポイントを開きます。以降に起動するものはすべて、そのエンドポイントを介してブリッジします。設定するものは何もなく、どのクライアントも違いを認識できません。所有者は<data-dir>/daemon.json(0600)に自身のpid、ポート、ブリッジが認証に使うトークンを公開します。

ブリッジは所有者が公開するものをそのまま提供するため、--read-onlyで起動された所有者は、クライアントがどのようなフラグで起動されたかにかかわらず、すべてのクライアントを読み取り専用にします。

所有者が終了するとブリッジも一緒に終了し、クライアントが次に起動するwazapが新しい所有者になります。

WAZAP_NO_SHARE=1でオプトアウトできます。同じディレクトリで2番目のwazapを起動すると、すでに実行中のpidを指定してコード2で終了します。明示的な--httpはブリッジではなく独自のサーバーであり、同じ方法で拒否されます。

読み取り専用モード

書き込みはオプトインです。loginは一度だけ確認し、その回答を<data-dir>/.envに保存します。wazap config writes on|offで変更でき、wazap configだけを実行すると、すべての有効な設定とその出所が表示されます。

WAZAP_READ_ONLY=1またはwazap serve --read-onlyでは、書き込みツールは一切登録されません。エージェントはそれらを認識できないため、誤ってでもあなたの番号から誰かにメッセージを送ることはできません。リンクしたアカウントが個人用の場合に便利です。

書き込みはWAZAP_RATE_LIMIT(デフォルト20、0で無効)により毎分レート制限もされます。人間より速く送信するとアカウントがBANされる原因になります。

HTTPモード

WAZAP_READ_TOKEN=$(openssl rand -hex 32) \
WAZAP_WRITE_TOKEN=$(openssl rand -hex 32) \
npx wazap-mcp serve --http --host 0.0.0.0 --port 8766

/mcpでStreamable HTTP、/healthzでヘルスチェックを提供します。2つのベアラートークンがあります。読み取りトークンは読み取りツールを取得し、書き込みトークンは書き込みツールもロック解除します。したがって、読み取りトークンが漏洩しても誰にもメッセージを送信できません。wazapは、読み取りトークンなしではループバック以外のアドレスへのバインドを拒否します。

セルフホスト

エージェントがノートPC上にない場合(別のマシン、VPS、クライアントのインフラ)は、独自のサーバーでwazapを実行します。セッションはそのサーバー上に留まり、第三者を経由するものはありません。

systemdを使用する場合

npm install -g wazap-mcp
sudo useradd --system --home /var/lib/wazap --create-home wazap
sudo -u wazap WAZAP_DATA_DIR=/var/lib/wazap wazap login --phone +15550100   # pairing code works over SSH
sudo -u wazap tee /var/lib/wazap/.env >/dev/null <<END
WAZAP_READ_TOKEN=$(openssl rand -hex 32)
WAZAP_WRITE_TOKEN=$(openssl rand -hex 32)
END
sudo curl -fsSL https://raw.githubusercontent.com/razvangirgiz/wazap/main/deploy/wazap.service -o /etc/systemd/system/wazap.service
sudo systemctl enable --now wazap
curl -s http://127.0.0.1:8766/healthz

ユニットはループバックのみにバインドします。2行のdeploy/Caddyfile(ホスト名を編集した後caddy run --config deploy/Caddyfile)または任意のリバースプロキシでTLSを前面に配置し、クライアントをAuthorization: Bearer <読み取りまたは書き込みトークン>付きでhttps://your-host/mcpに向けます。

Dockerを使用する場合

git clone https://github.com/razvangirgiz/wazap && cd wazap
printf 'WAZAP_READ_TOKEN=%s\nWAZAP_WRITE_TOKEN=%s\n' $(openssl rand -hex 32) $(openssl rand -hex 32) > .env
docker compose run --rm wazap login --phone +15550100   # once; the session lands in the wazap-data volume
docker compose up -d
curl -s http://127.0.0.1:8766/healthz

コンテナは8766をループバックのみに公開します。前面に同じTLSプロキシを追加します。アップグレードはgit pull && docker compose up -d --buildです。ボリュームがセッションを保持します。

到達できるクライアント

Claude Code、Claude Desktop、Cursor、Codex、VS Code、および「MCP URL + ヘッダー」フィールドを持つ任意のクライアントは、ベアラートークンで接続できます。claude.ai Connectorsは静的トークンではなくOAuthを必要とするため、セルフホストのwazapはまだ使用できません。読み取りのみが必要なクライアントには読み取りトークンを保持し、書き込みトークンは意図的に配布してください。

設定

変数

デフォルト

意味

WAZAP_DATA_DIR

~/.wazap

すべてが保存される場所。

WAZAP_READ_ONLY

0

書き込みツールを登録しない。

WAZAP_SYNC_FULL_HISTORY

0

WhatsAppにより完全な履歴同期を要求する。

WAZAP_PERSIST_HISTORY

1

再起動後もチャットとメッセージを保持する。

WAZAP_RATE_LIMIT

20

1分あたりの書き込みツール呼び出し数。0で無効。

WAZAP_TRANSPORT

stdio

stdioまたはhttp。

WAZAP_HOST / WAZAP_PORT

127.0.0.1 / 8766

HTTPバインドアドレス。

WAZAP_READ_TOKEN / WAZAP_WRITE_TOKEN

未設定

HTTPベアラートークン。

WAZAP_NO_UPDATE_CHECK

0

1にするとstatusがnpmに新しいバージョンを問い合わせない。

フラグは環境変数より優先され、環境変数は<data-dir>/.envより優先されます。

既知の制限

  • 非公式。 BaileysはWhatsAppのマルチデバイスプロトコルをリバースエンジニアリングしています。これはWhatsApp Business APIではなく、Metaはこれをサポートしていません。

  • BANのリスクは現実的です。 自動送信、一括メッセージ、人間がもっともらしく入力しないような操作は番号がBANされる可能性があり、ここから回復することはできません。レート制限は役立ちますが、保証ではありません。

  • メディアキーは期限切れになります。 WhatsAppは古い添付ファイルをサーバーから削除するため、古いメッセージに対するdownload_mediaはMEDIA_UNAVAILABLEを返します。

  • 履歴は電話が同期するものです。 wazapが参照するのは、WhatsAppがリンク済みデバイスに渡す履歴であり、電話の完全なアーカイブではありません。beforeを指定したread_messagesは、WhatsAppがまだ保持している範囲内でさらに要求します。

  • @lid ID。 新しいアカウントは電話番号ではなくプライバシーIDでアドレス指定されます。wazapはマッピングを学習済みの場合は電話番号に変換し直し、未学習の場合は@lidをそのまま渡します。

  • 電話が到達可能である必要があります。 リンク済みデバイスは、電話が十分に長くオフラインになると受信を停止します。get_statusはhintでその旨を伝えます。

開発

npm install
npm run typecheck
npm test                       # builds, then runs node --test
node test/smoke-stdio.mjs      # drives the built binary over MCP stdio
npm run dev -- status          # run from source with tsx

npm testはWhatsAppセッションを必要としません。stdioスモークテストは、使い捨てのデータディレクトリに対してビルド済みバイナリを起動し、リンクされていないインストールでもinitialize、tools/list、get_statusに応答することを確認します。

MITライセンス。

Available Tools

23 tools
catch_upCatch up on what the user missedA
Read-only

What the user missed, all accounts, within budget_tokens: waiting (every open ask of 14 days, whatever the window), mentions, calls, people, groups, stories. account_id narrows it to one account; get_status names them. The mark moves first; a lost answer is since: "previous". more.cursor: the rest.

Inputs: ids, hours, since, cursor, +3 more. Returns: more, notes, direct, footer, +9 more

confirm_sendSend a drafted WhatsApp messageA
Idempotent

Send a draft the user approved — this text, this recipient: the only call that sends, once per draft. A yes about something else: show the preview again and ask. Expired, missing or stale: draft again, show the new preview, ask again. SEND_OUTCOME_UNKNOWN: read_messages, never redo it unasked.

Inputs: draft_id (required), account_id.

delete_messageDelete a WhatsApp messageA
DestructiveIdempotent

Delete a message; confirm with the user first. for_everyone: true retracts it for everyone within 2 days: the account's own message, or anyone's in a group where it is admin. for_everyone: false removes any message from the linked account's devices only.

Inputs: message_id (required), for_everyone (required), account_id. Returns: account_id, message_id, for_everyone

edit_messageEdit a WhatsApp message you sentA
DestructiveIdempotent

Replace the text of a message the linked account sent. WhatsApp allows it for 15 minutes after sending; later, send a correction instead.

Inputs: text (required), message_id (required), account_id. Returns: text, chat_id, timestamp, account_id, +1 more

find_contactFind who the user meansA
Read-onlyIdempotent

Who a name, nickname, relationship ("mama"), filed detail ("AP-123"), group, number or id means, before drafting. resolved: contact.chat_id, with number, note, tags, details and, when writing, context. ambiguous or not_found: ask the user; never guess. Several accounts: see fix. tag: its people.

Inputs: tag, kind, name, limit, +3 more. Returns: fix, next, notes, query, +11 more

get_group_infoGet WhatsApp group infoA
Read-onlyIdempotent

A group's name, description, owner and participants (up to 500), whether the account is admin, its settings (info_locked, member_add_mode, join_approval, disappearing_seconds), its community, and the invite link for an admin. Call it before manage_group.

Inputs: group_id (required), account_id. Returns: name, owner, chat_id, community, +12 more

get_mediaGet the media of a WhatsApp messageB
Read-only

What a message's media holds: a voice note or audio as its transcript (kept once made; an API provider bills it); a photo or sticker as an image; a video as a sheet of frames; a document as its text and first page. A local call also saves the file (save_to). MEDIA_UNAVAILABLE: gone.

Inputs: pages, detail, save_to, language, +3 more. Returns: link, mime, path, size, +18 more

get_messageGet one WhatsApp message in fullB
Read-onlyIdempotent

One message in full, its words never cut: the message it quotes, each reaction with who left it, poll votes and event answers by person, its media, and on the user's own messages who it reached and who read it.

Inputs: message_id (required), account_id. Returns: text, chat_id, timestamp, account_id, +1 more

get_statusGet the WhatsApp connection statusA
Read-onlyIdempotent

Whether the account works: status (connected, not_linked, linking with its pairing code…), sync, how fresh the history is, webhook delivery, versions. accounts lists every account, with default. Call it on NOT_CONNECTED, NOT_LINKED or SYNC_IN_PROGRESS.

Inputs: account_id, include_picture.

learnLearn how to use the WhatsApp toolsA
Read-onlyIdempotent

The guide, one topic at a time: ids (formats, several accounts, the message shape), workflows, errors (what to do about each code), or all. Call it when unsure about ids, several accounts or an error code; with no topic it lists the topics. Never touches WhatsApp.

Inputs: topic, account_id.

list_chatsList WhatsApp chatsB
Read-onlyIdempotent

Conversations, most recently active first: chat_id, name, type, unread count, last message, and whether archived, pinned, muted or left. Use it to find a chat_id.

Inputs: tag, limit, cursor, filter, +2 more. Returns: tag, sync, chats, count, +3 more

list_contactsList the phone's address bookA
Read-onlyIdempotent

The phone's address book on one account, a page at a time: saved name, phone (E.164), chat_id, contact_id, and when the last direct message was and its direction. No message words; #private people left out. address_book_synced false: not arrived yet.

Inputs: limit, order, cursor, account_id.

manage_chatManage a WhatsApp chatA
Destructive

Preview archive, pin, mute, pin_message, star_message, clear, delete, block and undo. After approval repeat chat_id/action with confirmation_id, without options. Expires in 15m; one attempt. mark_read runs directly, only when the user asks.

Inputs: action (required), chat_id (required), pin_hours, account_id, +3 more.

manage_groupManage a WhatsApp groupA
Destructive

Create a group, join one from an invite (preview first, then confirm: true), or administer one: members, name, description, photo, invite link, join requests, settings, leave. Most actions need admin. Every change shows to all members at once: say what will change, wait for a yes.

Inputs: action (required), url, value, invite, +6 more. Returns: name, next, action, status, +10 more

react_to_messageReact to a WhatsApp messageA
Idempotent

React to a message with one emoji, or pass "" to take your reaction off.

Inputs: emoji (required), message_id (required), account_id. Returns: emoji, account_id, message_id

read_messagesRead messages from a WhatsApp chatA
Read-onlyIdempotent

Read one chat, oldest to newest: the latest messages, older ones with before (wazap asks the phone when the local history runs out), or a window with since/until. Long texts are cut unless full_text. chat_id "status": the stories of the last hours (a day at most), shown nowhere else.

Inputs: chat_id (required), hours, limit, since, +6 more. Returns: sync, count, hours, notes, +13 more

rememberRemember something about a personA
Idempotent

Keep what the user says about someone, locally, never on WhatsApp: a note, tags, details find_contact matches ({"relatie": "mama"}), or handled: true for an ask dealt with elsewhere. #private keeps their words out of what you did not ask about them by name; #no-catchup keeps them out of catch_up.

Inputs: chat_id (required), note, fields, handled, +4 more. Returns: name, note, tags, fields, +7 more

reminderSet, list or cancel a reminder about a chatA

The user's reminders about a chat, kept locally and posted to their webhook when due: create (chat_id, note, after_hours or due_at); condition "no_reply" fires only if nobody wrote there since ("if Ana has not answered in 2 days"). list, cancel. Nothing goes to WhatsApp.

Inputs: note, limit, action, due_at, +7 more. Returns: count, notes, action, cancelled, +2 more

scheduled_messagesList or cancel scheduled WhatsApp messagesA
Idempotent

The account's scheduled messages: list (waiting ones soonest first, then the week's sent, missed, failed and cancelled ones) or cancel one by schedule_id before it goes. To schedule one, send_message with send_at, then confirm_send. Tell the user about every missed or failed one.

Inputs: limit, action, account_id, schedule_id, +1 more. Returns: count, action, cancelled, scheduled, +1 more

send_messageDraft a WhatsApp messageA

Drafts text, media, polls, locations, forwards; sends nothing. Call it as soon as you have recipient and text: it returns draft_id and preview (recipient, number, exact text). Show that preview; confirm_send only on a yes to this text and recipient — a send in the same request is that yes.

Inputs: text (required), chat_id (required), as, url, +15 more.

wait_for_messagesWait for new WhatsApp messagesA
Read-onlyIdempotent

Wait for messages from other people, up to timeout_seconds, and return them with a cursor: pass it to the next call so nothing that lands between calls is missed. addressed_to_me wakes only for direct messages, mentions and replies to the user. For agents that stay on the line.

Inputs: cursor, chat_id, account_id, addressed_to_me, +1 more. Returns: count, cursor, messages, timed_out, +2 more

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 23 tools

    Disambiguation4/5

    Most tools map to a distinct resource+action, and the descriptions actively separate the message-reading cluster (read_messages, get_message, catch_up, wait_for_messages, search) by scenario. The draft/confirm_send split and the manage_chat vs manage_group overlap are the only places where an agent could hesitate, but both are explicitly clarified.

    Naming Consistency3/5

    The dominant pattern is verb_noun (list_chats, get_message, delete_message, manage_group), but several tools break it: bare verbs (learn, remember, search, catch_up) and bare nouns (scheduled_messages, reminder). The convention is readable but mixed enough to be noted.

    Tool Count4/5

    23 tools is on the heavy side, but the server spans multiple accounts, chats, groups, media, drafts, scheduling and reminders, so each tool covers a distinct slice rather than duplicating scope. It is at the upper edge of well-scoped rather than bloated.

    Completeness4/5

    The surface covers the full message lifecycle (draft, confirm, edit, delete, react), reading/search/triage, contacts, groups, media, scheduling, account linking/status and local reminders. Only minor gaps remain, such as profile/settings management and a standalone read-marking call outside manage_chat.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      WhatsApp MCP server that exposes messaging, groups, contacts, and profile management as tools and resources for AI agents, supporting Baileys and Meta Cloud API.
      79 npm
      29
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A self-hosted WhatsApp bridge that exposes a stdio MCP server with ~20 tools for reading conversations, sending messages, managing groups, contacts, and aliases, enabling AI agents to operate WhatsApp directly.
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that connects AI agents to WhatsApp using the multi-device API, enabling messaging, group management, and more as a regular user.
      6 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A native MCP server for SocialMate that gives your AI a WhatsApp, enabling it to send and read messages, manage contacts and groups, and more through 44 tools.
      46 npm
      1
      MIT