Whats App Mcp Server

これは、AI エージェント（Claude や Cursor など）が WhatsApp を介してあなたと直接やり取りできるようにする MCP（Model Context Protocol） サーバーです。自律型 AI とスマートフォンの橋渡しをし、コンピューターから離れている間も、実行時の確認、権限リクエスト、簡単なステータス更新を行えます。

• AI エージェントのメッセージ送信
• AI エージェントによる確認
• エージェントの割り込みシステム
• AI アラート
• MCP サーバー
• Cursor MCP
• Claude Desktop MCP
• AI 通知

こんな用途に最適

• Cursor
• Claude Desktop
• Claude Code
• OpenCode
• Codex
• 自律型 AI ワークフロー

例

AI： 本番環境にデプロイしますか？

WhatsApp： [YES] [NO]

あなた： YES

エージェントは処理を続けます。

---

🚀 クイックスタート（NPX）

このパッケージは NPM で公開されているため、MCP の設定から npx で直接実行できます。

Cursor / Claude の設定

MCP 設定ファイルに次の内容を追加します。

{
  "mcpServers": {
    "whatsapp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mhrj/whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_TARGET_NUMBER": "[email protected]"
      }
    }
  }
}

許可する番号に関する注意：WHATSAPP_TARGET_NUMBER は、すべてのメッセージのデフォルトの宛先です。ただし、宛先が WhatsApp グループの場合、デフォルトではグループ内の誰でも AI に返信できます。特定の番号からの返信のみを許可し、許可されていない人が返信できないようにするには、任意で環境変数にカンマ区切りの番号リストを追加できます："WHATSAPP_ALLOWED_NUMBERS": "[email protected],[email protected]"。設定すると、AI はこれらの番号に一致するユーザーからの応答のみを受け付けます。

npx: executable file not found in $PATH または env: node: No such file or directory のトラブルシューティング： IDE／エージェントで npx または node が見つからないというエラーが表示される場合、GUI アプリ（Cursor など）がターミナルの $PATH を引き継いでいないことが原因です。解決するには、MCP の env 設定で PATH を明示的に渡します。

      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
        "WHATSAPP_TARGET_NUMBER": "[email protected]"
      }

認証（初回のみ）

MCP サーバーを初めて使用する際は、WhatsApp Web で認証する必要があります。

1. エージェントから connect ツールを呼び出すか、通常どおり任意の WhatsApp ツールを使用します。セッションがまだ認証されていない場合、サーバーが自動的に認証を開始します。
2. ツールの結果として QR コード画像が MCP コンテンツ内に直接返されるため、最新のクライアントではインライン表示できます。
3. クライアントで画像をインライン表示できない場合、サーバーは代替手段として ~/.whatsapp-mcp/qr.html にローカルの HTML ページを書き込もうとします。
4. スマートフォンで WhatsApp を開き、［リンク済みデバイス］→［デバイスをリンク］を選択して、QR コードをスキャンします。
5. 認証セッションはホームディレクトリ（~/.whatsapp-mcp/baileys_auth_info）に保存されるため、再起動のたびにスキャンする必要はありません。

リモート「オートパイロット」ワークフロー（IDE のプロンプトをスキップ）

AI エージェントを完全に自律して動作させ、権限やガイダンスの確認を WhatsApp 経由でのみ行うようにするには（パソコンから離れていても作業を続けられるようにするには）、次の手順を実行します。

1. IDE のセキュリティによるブロックを解除する：エージェント（Cursor や Claude など）がコマンドの実行やファイルの読み取りの許可を求めたら、Always Allow を選択するか、設定で「yolo」モードを有効にします。これにより、UI 上でクリックされるまで延々と停止することなく、エージェントが作業できるようになります。
2. .cursorrules ファイル（またはシステムプロンプト）を追加する：AI が判断すべき段階に達したら、必ず WhatsApp を使うよう明示的に指示する必要があります。プロジェクトのルートに .cursorrules ファイルを作成し、次のプロンプトをそのまま記述します。

# Human-in-the-Loop via WhatsApp
You are connected to the user via the `whatsapp-mcp` server. 
Whenever you are about to make significant/destructive changes, run a deployment, or whenever you need the user's permission/opinion to proceed with a plan, you MUST use the `ask_question` tool to ask the user on WhatsApp. 
DO NOT simply ask for confirmation in the IDE chat interface. You must wait for the `ask_question` tool to return the user's WhatsApp reply before proceeding with your task.

この 2 つの手順を実行すると、AI は IDE で停止する代わりに、ask_question ツールを積極的に使って、判断に必要な許可の確認を直接あなたのスマートフォンに送信するようになります。

機能とツール

• connect：WhatsApp ネットワークに接続します。ログインしていない場合は、ツールの結果としてネイティブの QR 画像を返し、ローカル HTML の代替手段も提供することがあります。
• disconnect：WhatsApp から完全にログアウトし、セッションの認証情報を無効にします。
• send_message：一方向の通知を送信します。WhatsApp の Markdown 形式へのマッピング（*bold*）を任意でサポートします。サーバーがまだ接続されていない場合は、認証を自動的に開始します。
• ask_question：プロンプトを送信し、返信を受信するまで（タイムアウト付きで）実行を一時停止します。複数の質問は賢くキューに登録され、参照情報が付与されます。サーバーがまだ接続されていない場合は、認証を自動的に開始します。
• get_incoming_messages：自発的に送信された WhatsApp メッセージをポーリングします。これにより、サーバー側サンプリングをサポートしていないエージェントもメッセージを取得できます。
• get_status：connected、connecting、qr_pending などの認証状態を含め、エージェントの接続状態を監視できます。
• サーバーの指示とプロンプト：サーバーは、組み込みのワークフロー指示と whatsapp-autopilot プロンプトを提供し、クライアントがエージェントを「まず接続し、WhatsApp を優先する」動作へ導けるようにします。

ローカル開発

ソースからローカルで実行する場合は、次の手順に従います。

1. リポジトリをクローンして npm install を実行します
2. npm run build を実行します
3. npx ではなく、絶対パスを使ってリンクします。

ライセンス

このプロジェクトは ISC License の下でライセンスされています。

サードパーティライセンス

このプロジェクトでは、次のオープンソースライブラリを使用しています。

• @modelcontextprotocol/sdk - MIT License
• @whiskeysockets/baileys - MIT License
• その他の依存関係（express、pino、qrcode など）は、許容的なライセンス（MIT/BSD）の下でライセンスされています。

---

検索キーワード

• Human in the loop AI
• AI approvals
• Runtime approvals
• Agent notifications
• Agent approval workflow
• Cursor WhatsApp integration
• Claude WhatsApp integration
• Autonomous agents
• Cursor power users
• Remote workers

このツールで解決できる問題

• IDE から離れると、AI エージェントが承認や質問への回答を待って停止してしまうことがよくあります。
• WhatsApp MCP はスマートフォンに通知を送信して確認を受け取るため、エージェントは安全に作業を続けられます。

対象ユーザー

• Cursor エージェント／Claude Desktop のユーザー
• エージェント型ワークフローを構築してリリースする個人開発者
• 実行時の承認を必要とする DevOps チームと自動化チーム