WhatsApp Messaging API

WhatsApp Messaging API — MCP サーバー

Claude、Cursor、または任意の MCP クライアントから WhatsApp メッセージを送信できます。セッションを作成して QR コードをスキャンすれば、テキスト、画像、ファイルを送信できます。Meta Business の承認も WhatsApp Business アカウントも必要ありません。

WhatsApp Messaging API をラップしています。

クイックスタート

1. RapidAPI から無料の API キーを取得します。クレジットカードは不要です。

2. MCP クライアントの設定に以下を追加します（Claude Desktop の場合：claude_desktop_config.json）。

   {
     "mcpServers": {
       "whatsapp": {
         "command": "npx",
         "args": ["-y", "whatsapp-messaging-api-mcp"],
         "env": {
           "WHATSAPP_API_KEY": "your-rapidapi-key"
         }
       }
     }
   }
   

3. クライアントを再起動します。WhatsApp セッションを作成して QR コードを表示するよう依頼してください。

インストールやビルドは不要です。初回実行時に npx がパッケージを取得します。

ツール

ツール	説明
list_sessions	この API キーのすべてのセッションを一覧表示します
create_session	新しいセッションを作成します
get_session_status	セッションの現在のステータスを確認します
get_qr_code	セッションを認証するための QR コードを取得します
request_pairing_code	QR コードの代わりに 8 桁のペアリングコードを取得します
check_contact_exists	送信前に電話番号が WhatsApp に登録されているか確認します
send_text_message	テキストメッセージを送信します
send_image	URL 経由で画像を送信します
send_file	URL 経由でファイル（PDF、ドキュメント）を送信します

一般的な流れ

1. create_session → get_qr_code → WhatsApp でスキャンします（設定 → リンク済みデバイス）
2. WORKING と表示されるまで get_session_status を実行します
3. check_contact_exists を実行し、その後 send_text_message / send_image / send_file を実行します

セッションは実行間で認証状態が保持されるため、手順 1～2 は電話番号ごとに一度だけ行います。

設定

変数	必須	説明
WHATSAPP_API_KEY	はい	RapidAPI キーです。設定されていない場合、サーバーは起動時に終了します。

キーは環境から読み込まれ、API ホストにのみ送信されます。ログに記録されることはありません。

ローカル開発

git clone https://github.com/jevil25/whatsapp-messaging-api-mcp.git
cd whatsapp-messaging-api-mcp
npm install
npm run dev      # runs src/index.ts directly via tsx, no build step
npm run build    # compile to dist/
npm test         # boots the built server and drives a real MCP handshake

npm test の実行に認証情報は不要です。ダミーキーを渡すことで、ツールの一覧表示まで進みます。ハンドシェイクでは API 呼び出しが行われないためです。

ローカルビルドを MCP クライアントから指定するには、"command": "node" と "args": ["/absolute/path/to/dist/index.js"] を使用します。

リリース手順については、DEVELOPING.md を参照してください。

リンク

• npm パッケージ
• MCP レジストリーのエントリー — io.github.jevil25/whatsapp-messaging-api-mcp
• WhatsApp Messaging API のドキュメント

ライセンス

MIT