WhatsApp MCP

npx add-mcp 'https://server.wa-mcp.com/mcp'

WhatsApp MCP ドキュメント

WhatsApp MCP は、お使いの AI アシスタント（Claude、ChatGPT、Cursor、または Model Context Protocol をサポートする任意のクライアント）を、すでに使用している WhatsApp 番号に接続します。アシスタントはチャットを読み取り・検索し、返信待ちの相手を見つけ、メッセージの送信・予約・編集・リアクションを、常にあなた自身の番号から、あなたが依頼したときだけ行えます。

WhatsApp Web と同じように、WhatsApp にリンク済みデバイスとして接続します。インストールするアプリも、新しい番号も、Meta Business API も不要です。

セットアップ

一度接続すれば、あとはチャットで WhatsApp をリンクするだけです。

オプション A: Claude のコネクタディレクトリ

1. Claude でコネクタディレクトリを開き、WhatsApp MCP を見つけます。
2. 接続をクリックします。当社の接続ページが開くので、お使いの AI アプリ名が表示されていることを確認し、もう一度接続をクリックします。
3. Claude に戻り、新しいチャットを開いて 「Connect my WhatsApp」 と入力します（下記「WhatsApp をリンクする」を参照）。

サインアップもパスワードもありません。あなたの WhatsApp 番号がアカウントであり、それをリンクすることで本人確認を行います。

オプション B: 個人用接続 URL（任意の MCP クライアント）

1. wa-mcp.com にアクセスし、お使いの AI アプリを選択してマイリンクを生成をクリックします。
2. そのリンクをカスタムコネクタ（MCP サーバー）として AI アプリに追加します。サイトには各アプリの正確な手順が表示され、Claude を WhatsApp に接続する方法では Claude の手順を順を追って説明しています。
3. 新しいチャットを開いて 「Connect my WhatsApp」 と入力します。

リンクはパスワードのように扱い、他人に知られないようにしてください。同じリンクを複数の AI アプリで使用できます。

WhatsApp をリンクする

アシスタントに WhatsApp の接続を依頼すると、2 つの方法が提示されます。

• QR コード: アシスタントが QR コード（およびそのコードを表示するページへのリンク）を表示します。スマートフォンで WhatsApp を開き、設定 → リンク済みデバイス → デバイスをリンク を選んでスキャンします。
• ペアリングコード: アシスタントに国番号付きの電話番号を伝えます。8 文字のコードが返ってきます。スマートフォンで リンク済みデバイス → デバイスをリンク → 電話番号でリンク を開き、コードを入力します。

リンク後、WhatsApp は最近の履歴（最大約 90 日分）をリンク済みデバイスに同期します。アカウントのデータ量が多い場合は数分かかることがあります。

プラン

• 無料トライアル: 初めて電話番号をリンクしてから 1 時間、すべての機能を利用できます。
• 無料プラン: トライアル終了後も、チャットの読み取り・要約・検索とテキストメッセージの送信は引き続き利用できます。テキストメッセージの末尾には「Sent via wa-mcp.com」が付き、新しい会話（過去 90 日間にあなたへメッセージを送っていない相手）を開始することはできません。
• 有料プラン: ファイル（写真、動画、ボイスメッセージ、ドキュメント）、メッセージの予約、編集、リアクション、削除、迷惑行為対策のガードレール付きの新しい会話、およびラベルなしでの送信が利用できます。

アシスタントに 「What plan am I on?」 と尋ねると、現在のプランとサブスクリプションの選択肢を確認できます。

ツール

ツールの選択はアシスタントが行います。あなたは普通の言葉で依頼するだけです。

読み取り

ツール	機能
get_recent_chats	最近のチャットと、それぞれの最新メッセージ。
get_unanswered_chats	最後のメッセージが相手からのチャット。誰が返信を待っているかがわかります。
read_chat_history	特定のチャット、個人、またはグループのメッセージ。
search_messages	メッセージのテキストを検索します。特定のチャット内や特定の相手からのメッセージに絞り込むこともできます。
search_contacts	名前または番号で連絡先やグループを検索します。
download_media	メッセージに含まれる写真、ボイスメッセージ、動画、ドキュメント、スタンプを開きます。
get_writing_style	あなたの文章の例。下書きがあなたらしい文体になるようにします。

書き込み

ツール	機能
send_message	テキスト、またはリンク先のファイルを個人やグループに送信します。最初に入力中インジケーターを表示します。
schedule_message	メッセージを後で送信するよう予約します。1 回のみ、または繰り返し（毎日、毎週、毎月など）設定できます。
list_scheduled_messages	予定されているメッセージの一覧と、過去のメッセージの履歴。
cancel_scheduled_message	予約済みメッセージをキャンセルします（すべての繰り返しを含む）。
react_to_message	メッセージに絵文字でリアクションする、またはリアクションを削除します。
edit_message	自分が送信したメッセージのテキストを変更します。
delete_message	自分が送信したメッセージを全員に対して削除します。
mark_as_read	チャットを既読にします。

接続とアカウント

ツール	機能
get_session_status	WhatsApp がリンクされ、接続されているかどうか。
get_pairing_qr	QR コードによるリンクを開始します。
request_pairing_code	ペアリングコードによるリンクを開始します。
restart_session	メッセージが届かなくなった場合に WhatsApp へ再接続します。
manage_subscription	現在のプランとサブスクリプションの選択肢を表示します。
report_feedback	バグ報告や機能リクエストを当社に送信します。
unlink_whatsapp	WhatsApp のリンクを解除します（アカウントは残ります）。
delete_account	確認後、アカウントとすべてのデータを削除します。

プロンプトの例

• 「昨日から私への返信を待っているのは誰？」
• 「今週、家族グループで話された内容を要約して。」
• 「カルロスが住所を送ってきたメッセージを探して。」
• 「アナに、注文は木曜日に発送されると伝えて。」（正確な文面を指定しない限り、アシスタントはまず下書きを表示します）
• 「毎週月曜日の午前 9 時に、チームグループへ週次アップデートの送信をリマインドして。」

安全性

• 送信内容はあなたが管理します。 アシスタントがメッセージを書くときは、正確なテキストを指定しない限り、送信前に下書きを表示します。
• 迷惑行為対策のガードレール。 過去 90 日間にあなたへメッセージを送っていない相手へのメッセージは、間隔を空けて送信されます（1 分間に最大 1 件、12 時間ごとに最大 10 人まで）。これは番号がスパムとしてフラグ付けされるのを防ぐためです。あなたへメッセージを送ってきた相手とのチャットには制限がありません。一括送信のツールはありません。
• 入力中インジケーター。 各メッセージの前に、あなたが入力したときと同じように短い「入力中…」が表示されます。

トラブルシューティング

• 「WhatsApp is not linked」: リンク済みデバイスが削除されました（スマートフォンから、またはリンク解除による）。アシスタントに、同じ番号で WhatsApp を再度接続するよう依頼してください。
• ペアリングコードが機能しない: コードは短時間で期限切れになります。新しいコードを要求し、番号に国番号が含まれていることを確認し、スマートフォンで電話番号でリンクを使用してください。
• メッセージが届かなくなった: アシスタントに WhatsApp 接続の再起動を依頼してください。スマートフォンの WhatsApp が約 14 日間オフラインだった場合、WhatsApp はリンク済みデバイスをログアウトします。スマートフォンで WhatsApp を開いてから、再度リンクしてください。
• 「This connection is permanently registered to phone number…」: 各接続は 1 つの電話番号に紐づきます。別の番号を使用するには、リンクを解除してからコネクタを削除して再度追加します（個人用 URL の場合は、新しい URL を生成します）。
• コネクタが接続されていないと表示される（ディレクトリユーザーの場合）: コネクタから WhatsApp MCP を削除して再度接続し、同じ電話番号をリンクしてください。アカウントとサブスクリプションは引き継がれます。

プライバシーとデータ

メッセージは、アシスタントが検索できるように当社のサーバーに 90 日間保存され、広告や AI のトレーニングに使用されることは一切ありません。アシスタントが読み取る内容は、そのプロバイダーのポリシーに従ってプロバイダーが処理します。いつでもアシスタントに WhatsApp のリンク解除またはアカウントの削除を依頼できます。削除するとすべてのデータが即座に消去されます。詳細はプライバシーポリシーと利用規約をご覧ください。