プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

WhatsApp MCP

作者:adelaidasofiaバージョン 0.1.1i★ 7iパソコンで動くリポジトリ ↗
レジストリ名io.github.adelaidasofia/whatsapp-mcp

インストール方法

What it does

WhatsApp MCP. SQLCipher-encrypted, scrubber-CI-gated, draft-and-confirm sends, voice transcription.

  • Connects パソコンで動く
  • Account or key Needs WHATSAPP_WHISPER_API_KEY
  • Category チャット・メール

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気11/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア23/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

WhatsApp MCP をインストールして。https://mcp.popnx.com/i/adelaidasofia-whatsapp-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

WhatsApp MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server WhatsApp MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "whatsapp": { "command": "uvx", "args": [ "adelaidasofia-whatsapp-mcp" ], "env": { "WHATSAPP_WHISPER_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) WHATSAPP_WHISPER_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、WhatsApp MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. WhatsApp MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  4. この設定を貼り付けて保存

    {
      "mcpServers": {
        "whatsapp": {
          "command": "uvx",
          "args": [
            "adelaidasofia-whatsapp-mcp"
          ],
          "env": {
            "WHATSAPP_WHISPER_API_KEY": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude を終了してもう一度開く

  6. 試してみる

    WhatsApp MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が WhatsApp MCP を使っていると言うか、回答に WhatsApp MCP のツール名が出れば接続成功です

追加の設定 8 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • WHATSAPP_BRIDGE_HOST Go bridge の REST API 用のホスト名。
    英語の原文を見るHostname for the Go bridge REST API.
    · 初期値 127.0.0.1
  • WHATSAPP_BRIDGE_PORT Go bridge REST API のポート。
    英語の原文を見るPort for the Go bridge REST API.
    · 初期値 8080
  • WHATSAPP_VAULT_CRM_PATH 自動挿入用の vault CRM フォルダへの絶対パス(例: Obsidian の 'CRM/')。未設定の場合、CRM 挿入は無効です。
    英語の原文を見るAbsolute path to a vault CRM folder for auto-injection (e.g., Obsidian 'CRM/'). When unset, CRM injection is disabled.
  • WHATSAPP_WHISPER_BACKEND ボイスメモの文字起こしバックエンド。'local-cpp'(既定・非公開)または 'openai-api'(オプトイン)。
    英語の原文を見るVoice-note transcription backend. 'local-cpp' (default, private) or 'openai-api' (opt-in).
    · 初期値 local-cpp
  • WHATSAPP_WHISPER_MODEL whisper.cpp のモデル名。backend が local-cpp の場合のみ使用されます。
    英語の原文を見るwhisper.cpp model name. Only used when backend is local-cpp.
    · 初期値 large-v3
  • WHATSAPP_SCRUB_PROMPT_INJECTION 既知のプロンプトインジェクションのパターンを、受信メッセージから LLM に渡す前に除去する。
    英語の原文を見るStrip known prompt-injection patterns from incoming messages before the LLM sees them.
    · 初期値 true
  • WHATSAPP_AUDIT_LOG すべてのツール呼び出しを audit.log に記録します。
    英語の原文を見るLog every tool call to audit.log.
    · 初期値 true
  • WHATSAPP_ENCRYPT_DB SQLCipher によるデータベース暗号化を有効にします。鍵は macOS のキーチェーンから取得されます。
    英語の原文を見るEnable SQLCipher DB encryption with the key sourced from macOS Keychain.
    · 初期値 true

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ WhatsApp MCP につなげません

WhatsApp MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · WhatsApp MCP につなげるアプリを使う

  • WhatsApp MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • WhatsApp MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • WhatsApp MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • WhatsApp MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · チャット・メール の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

WhatsApp MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server WhatsApp MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user whatsapp --env WHATSAPP_WHISPER_API_KEY=your-value -- uvx adelaidasofia-whatsapp-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) WHATSAPP_WHISPER_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、WhatsApp MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. WhatsApp MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  4. このコマンドを貼り付けて Enter

    claude mcp add --scope user whatsapp --env WHATSAPP_WHISPER_API_KEY=your-value -- uvx adelaidasofia-whatsapp-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude Code で /mcp と入力

    WhatsApp MCP が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    WhatsApp MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が WhatsApp MCP を使っていると言うか、回答に WhatsApp MCP のツール名が出れば接続成功です

追加の設定 8 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • WHATSAPP_BRIDGE_HOST Go bridge の REST API 用のホスト名。
    英語の原文を見るHostname for the Go bridge REST API.
    · 初期値 127.0.0.1
  • WHATSAPP_BRIDGE_PORT Go bridge REST API のポート。
    英語の原文を見るPort for the Go bridge REST API.
    · 初期値 8080
  • WHATSAPP_VAULT_CRM_PATH 自動挿入用の vault CRM フォルダへの絶対パス(例: Obsidian の 'CRM/')。未設定の場合、CRM 挿入は無効です。
    英語の原文を見るAbsolute path to a vault CRM folder for auto-injection (e.g., Obsidian 'CRM/'). When unset, CRM injection is disabled.
  • WHATSAPP_WHISPER_BACKEND ボイスメモの文字起こしバックエンド。'local-cpp'(既定・非公開)または 'openai-api'(オプトイン)。
    英語の原文を見るVoice-note transcription backend. 'local-cpp' (default, private) or 'openai-api' (opt-in).
    · 初期値 local-cpp
  • WHATSAPP_WHISPER_MODEL whisper.cpp のモデル名。backend が local-cpp の場合のみ使用されます。
    英語の原文を見るwhisper.cpp model name. Only used when backend is local-cpp.
    · 初期値 large-v3
  • WHATSAPP_SCRUB_PROMPT_INJECTION 既知のプロンプトインジェクションのパターンを、受信メッセージから LLM に渡す前に除去する。
    英語の原文を見るStrip known prompt-injection patterns from incoming messages before the LLM sees them.
    · 初期値 true
  • WHATSAPP_AUDIT_LOG すべてのツール呼び出しを audit.log に記録します。
    英語の原文を見るLog every tool call to audit.log.
    · 初期値 true
  • WHATSAPP_ENCRYPT_DB SQLCipher によるデータベース暗号化を有効にします。鍵は macOS のキーチェーンから取得されます。
    英語の原文を見るEnable SQLCipher DB encryption with the key sourced from macOS Keychain.
    · 初期値 true

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

WhatsApp MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server WhatsApp MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "whatsapp": { "command": "uvx", "args": [ "adelaidasofia-whatsapp-mcp" ], "env": { "WHATSAPP_WHISPER_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) WHATSAPP_WHISPER_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、WhatsApp MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. WhatsApp MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    WhatsApp MCP の設定で WHATSAPP_WHISPER_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    WhatsApp MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が WhatsApp MCP を使っていると言うか、回答に WhatsApp MCP のツール名が出れば接続成功です

追加の設定 8 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • WHATSAPP_BRIDGE_HOST Go bridge の REST API 用のホスト名。
    英語の原文を見るHostname for the Go bridge REST API.
    · 初期値 127.0.0.1
  • WHATSAPP_BRIDGE_PORT Go bridge REST API のポート。
    英語の原文を見るPort for the Go bridge REST API.
    · 初期値 8080
  • WHATSAPP_VAULT_CRM_PATH 自動挿入用の vault CRM フォルダへの絶対パス(例: Obsidian の 'CRM/')。未設定の場合、CRM 挿入は無効です。
    英語の原文を見るAbsolute path to a vault CRM folder for auto-injection (e.g., Obsidian 'CRM/'). When unset, CRM injection is disabled.
  • WHATSAPP_WHISPER_BACKEND ボイスメモの文字起こしバックエンド。'local-cpp'(既定・非公開)または 'openai-api'(オプトイン)。
    英語の原文を見るVoice-note transcription backend. 'local-cpp' (default, private) or 'openai-api' (opt-in).
    · 初期値 local-cpp
  • WHATSAPP_WHISPER_MODEL whisper.cpp のモデル名。backend が local-cpp の場合のみ使用されます。
    英語の原文を見るwhisper.cpp model name. Only used when backend is local-cpp.
    · 初期値 large-v3
  • WHATSAPP_SCRUB_PROMPT_INJECTION 既知のプロンプトインジェクションのパターンを、受信メッセージから LLM に渡す前に除去する。
    英語の原文を見るStrip known prompt-injection patterns from incoming messages before the LLM sees them.
    · 初期値 true
  • WHATSAPP_AUDIT_LOG すべてのツール呼び出しを audit.log に記録します。
    英語の原文を見るLog every tool call to audit.log.
    · 初期値 true
  • WHATSAPP_ENCRYPT_DB SQLCipher によるデータベース暗号化を有効にします。鍵は macOS のキーチェーンから取得されます。
    英語の原文を見るEnable SQLCipher DB encryption with the key sourced from macOS Keychain.
    · 初期値 true

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

WhatsApp MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server WhatsApp MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "whatsapp": { "type": "stdio", "command": "uvx", "args": [ "adelaidasofia-whatsapp-mcp" ], "env": { "WHATSAPP_WHISPER_API_KEY": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) WHATSAPP_WHISPER_API_KEY は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、WhatsApp MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. WhatsApp MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    WhatsApp MCP の設定で WHATSAPP_WHISPER_API_KEY が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    WhatsApp MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が WhatsApp MCP を使っていると言うか、回答に WhatsApp MCP のツール名が出れば接続成功です

追加の設定 8 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • WHATSAPP_BRIDGE_HOST Go bridge の REST API 用のホスト名。
    英語の原文を見るHostname for the Go bridge REST API.
    · 初期値 127.0.0.1
  • WHATSAPP_BRIDGE_PORT Go bridge REST API のポート。
    英語の原文を見るPort for the Go bridge REST API.
    · 初期値 8080
  • WHATSAPP_VAULT_CRM_PATH 自動挿入用の vault CRM フォルダへの絶対パス(例: Obsidian の 'CRM/')。未設定の場合、CRM 挿入は無効です。
    英語の原文を見るAbsolute path to a vault CRM folder for auto-injection (e.g., Obsidian 'CRM/'). When unset, CRM injection is disabled.
  • WHATSAPP_WHISPER_BACKEND ボイスメモの文字起こしバックエンド。'local-cpp'(既定・非公開)または 'openai-api'(オプトイン)。
    英語の原文を見るVoice-note transcription backend. 'local-cpp' (default, private) or 'openai-api' (opt-in).
    · 初期値 local-cpp
  • WHATSAPP_WHISPER_MODEL whisper.cpp のモデル名。backend が local-cpp の場合のみ使用されます。
    英語の原文を見るwhisper.cpp model name. Only used when backend is local-cpp.
    · 初期値 large-v3
  • WHATSAPP_SCRUB_PROMPT_INJECTION 既知のプロンプトインジェクションのパターンを、受信メッセージから LLM に渡す前に除去する。
    英語の原文を見るStrip known prompt-injection patterns from incoming messages before the LLM sees them.
    · 初期値 true
  • WHATSAPP_AUDIT_LOG すべてのツール呼び出しを audit.log に記録します。
    英語の原文を見るLog every tool call to audit.log.
    · 初期値 true
  • WHATSAPP_ENCRYPT_DB SQLCipher によるデータベース暗号化を有効にします。鍵は macOS のキーチェーンから取得されます。
    英語の原文を見るEnable SQLCipher DB encryption with the key sourced from macOS Keychain.
    · 初期値 true

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?WhatsApp MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user whatsapp --env WHATSAPP_WHISPER_API_KEY=your-value -- uvx adelaidasofia-whatsapp-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "whatsapp": {
      "command": "uvx",
      "args": [
        "adelaidasofia-whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_WHISPER_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "whatsapp": {
      "command": "uvx",
      "args": [
        "adelaidasofia-whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_WHISPER_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "whatsapp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "adelaidasofia-whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_WHISPER_API_KEY": "your-value"
      }
    }
  }
}

自分で入力する値

  • WHATSAPP_BRIDGE_HOST env
    Go bridge の REST API 用のホスト名。
    英語の原文を見るHostname for the Go bridge REST API.
  • WHATSAPP_BRIDGE_PORT env
    Go bridge REST API のポート。
    英語の原文を見るPort for the Go bridge REST API.
  • WHATSAPP_VAULT_CRM_PATH env
    自動挿入用の vault CRM フォルダへの絶対パス(例: Obsidian の 'CRM/')。未設定の場合、CRM 挿入は無効です。
    英語の原文を見るAbsolute path to a vault CRM folder for auto-injection (e.g., Obsidian 'CRM/'). When unset, CRM injection is disabled.
  • WHATSAPP_WHISPER_BACKEND env
    ボイスメモの文字起こしバックエンド。'local-cpp'(既定・非公開)または 'openai-api'(オプトイン)。
    英語の原文を見るVoice-note transcription backend. 'local-cpp' (default, private) or 'openai-api' (opt-in).
  • WHATSAPP_WHISPER_API_KEY 秘密 必須 env
    OpenAI API キーです。WHATSAPP_WHISPER_BACKEND=openai-api の場合にのみ必要です。
    英語の原文を見るOpenAI API key. Required only when WHATSAPP_WHISPER_BACKEND=openai-api.
  • WHATSAPP_WHISPER_MODEL env
    whisper.cpp のモデル名。backend が local-cpp の場合のみ使用されます。
    英語の原文を見るwhisper.cpp model name. Only used when backend is local-cpp.
  • WHATSAPP_SCRUB_PROMPT_INJECTION env
    既知のプロンプトインジェクションのパターンを、受信メッセージから LLM に渡す前に除去する。
    英語の原文を見るStrip known prompt-injection patterns from incoming messages before the LLM sees them.
  • WHATSAPP_AUDIT_LOG env
    すべてのツール呼び出しを audit.log に記録します。
    英語の原文を見るLog every tool call to audit.log.
  • WHATSAPP_ENCRYPT_DB env
    SQLCipher によるデータベース暗号化を有効にします。鍵は macOS のキーチェーンから取得されます。
    英語の原文を見るEnable SQLCipher DB encryption with the key sourced from macOS Keychain.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
34/週
接続方法
パソコンで動く
最新バージョンi
0.1.1
レジストリ公開日i
2026年5月20日
コードの最終更新i
2026年11月18日
作者
adelaidasofia
パッケージ
pypi: adelaidasofia-whatsapp-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント adelaidasofia で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に adelaidasofia-whatsapp-mcp@0.1.1 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/adelaidasofia-whatsapp-mcp.svg)](https://mcp.popnx.com/en/servers/adelaidasofia-whatsapp-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

チャット・メールのほかのサーバーとの比較i

  • このカテゴリのほかの2009件のうち94%よりスターが多い
  • このカテゴリのほかの2009件のうち7%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの2009件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

WhatsApp MCPは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:WHATSAPP_WHISPER_API_KEY

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.1.1)がレジストリに届いたのは6 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

作者:anypost広く使われている↓ 5432/週★ 13945 日前更新

パソコンでもクラウドでも✓ 提供元 · emailmd.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

作者:infobip初期★ 3613 か月前更新

クラウドで動く✓ 提供元 · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

作者:w1ne初期★ 3523 日前更新

クラウドで動く✓ 提供元 · kernelcad.com
似たものと比べる
これ
WhatsApp MCP
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
動く場所パソコンにインストールが必要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック3/35/54/44/44/44/4
ライセンスMITMITAGPL-3.0Apache-2.0MITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

whatsapp-mcp

A WhatsApp MCP server for Claude, built directly on whatsmeow. Encrypted at rest, prompt-injection-scrubbed, draft-and-confirm on every send, full audit trail, daily CI security gates. Actively maintained.

Why this one?

The most-starred WhatsApp MCP (lharries/whatsapp-mcp, 5.6K stars) is the architectural reference for this pattern, but has not shipped since July 2025 and leaves the lethal-trifecta problem entirely to the user. This implementation closes the gaps:

CanonicalThis implementation
Last shippedJuly 2025Active
DB encryptionPlain SQLiteSQLCipher with key in the platform secret store (macOS Keychain / Windows Credential Manager / libsecret)
Prompt-injection scrubberNoneEvery inbound message
Send safetyFires immediatelyMandatory confirm_send between draft and delivery
Audit logNoneEvery tool call, 30-day retention
Voice notesNot transcribedwhisper.cpp local, language detected per note, turned on with one command
LID alias resolutionOpen issue cluster upstreamShipped, with backfill migration for legacy threads
CI securityNonegovulncheck + pip-audit + Dependabot, daily

Not a fork. The Go bridge is built directly against whatsmeow; the Python MCP layer and SQLite schema are original. Other implementations (lharries, LukasHaas, verygoodplugins) were read as reference only.

What this gives you

Claude can:

  • Read your WhatsApp chats, messages, and contacts
  • Search messages with accent-insensitive, typo-tolerant matching
  • Transcribe voice notes locally via whisper.cpp (language detected per note). Off until you say yes; Claude offers it once, and python3 whatsapp-mcp-server/enable_transcription.py turns it on in one step
  • Resolve LID (Linked IDentifier) names instead of numeric placeholders
  • Send text messages, reactions, and reply-quotes, with a mandatory confirm_send step between draft and delivery
  • Pull matching CRM context from your Obsidian vault when reading a chat
  • See only prompt-injection-scrubbed message text, never raw adversarial input

Everything runs locally on your machine. No cloud sync. No telemetry. Optional OpenAI Whisper backend is opt-in, off by default.

Architecture

Two components, both local:

  • `whatsapp-bridge/` (Go). Binds to 127.0.0.1 only. Wraps whatsmeow for the WhatsApp Web multidevice protocol. Owns SQLite persistence with SQLCipher encryption. Handles QR and pairing-code auth (live-refreshing terminal QR with Windows-safe rendering, plus a headless auth API — GET /api/auth/qr, POST /api/auth/pair-phone, POST /api/auth/reconnect — so a GUI or supervisor can drive pairing without a terminal), media up/download, session recovery from StreamReplaced conflicts, call history capture. Exposes a REST API the Python MCP layer consumes.
  • `whatsapp-mcp-server/` (Python, FastMCP). Consumes the Go bridge REST API. Exposes 11 MCP tools to Claude: full read surface (chats, messages, contacts), accent-insensitive search, presence (typing, online, mark-read), and text-send + reactions + reply-quotes with mandatory confirm_send. Runs via uv and stdio transport.

Install

Open Claude Code, paste:

/plugin marketplace add adelaidasofia/whatsapp-mcp /plugin install whatsapp-mcp@whatsapp-mcp

This installs the Python MCP server side. The Go bridge still needs the one-time QR pairing flow with your phone — see the legacy install block below for those steps.

Manual install (full Go bridge + QR pairing)

See SETUP.md for step-by-step install per OS. In short:

  1. Grab a prebuilt bridge binary from Releases (Windows/macOS/Linux — no compiler needed), or build from source (Go 1.26+ and a C toolchain)
  2. Python 3.11+ and uv for the MCP server layer
  3. Clone this repo; verify with scripts/check_prerequisites.sh (Windows: scripts\check_prerequisites.ps1)
  4. Start the bridge: ./bin/whatsapp-bridge (Windows: .\bin\whatsapp-bridge.exe)
  5. Scan the QR (it refreshes in place — always scan the one on screen), or pair by typed code with --pair-phone +15551234567
  6. Register the MCP in your Claude Code .mcp.json
  7. Restart Claude Code

FFmpeg and whisper.cpp are only needed if you enable voice-note transcription (off by default); enable_transcription.py configures them for you, and installs them with Homebrew on a Mac (SETUP.md step 4).

Configuration

All configurable via environment variables. See .env.example for the full list.

Key variables:

VariableDefaultPurpose
WHATSAPP_BRIDGE_PORT8080Go bridge REST API port
WHATSAPP_DB_PATH$HOME/.claude/whatsapp-mcp/store/messages.dbEncrypted SQLite database
WHATSAPP_MEDIA_PATH$HOME/.claude/whatsapp-mcp/media/Media file storage
WHATSAPP_VAULT_CRM_PATHemptyAbsolute path to your vault CRM folder for auto-injection (e.g., Obsidian 👤 CRM/). When unset, CRM injection is disabled.
WHATSAPP_WHISPER_BACKENDoffoff (zero-config boot), local-cpp (private, needs a whisper model), or openai-api (opt-in)
WHATSAPP_WHISPER_API_KEYemptyRequired only when backend is openai-api
WHATSAPP_WHISPER_MODELlarge-v3-turbowhisper.cpp model name
WHATSAPP_WHISPER_LANGUAGEautoLanguage passed to whisper. auto detects it per voice note; a fixed code (es, en) forces every note through it
WHATSAPP_KEEP_VOICE_AUDIOtrueWhile transcription is off, save each incoming voice note's audio (voice notes only, never view-once or disappearing ones) under WHATSAPP_MEDIA_PATH, so turning transcription on later also covers notes older than WhatsApp's ~14 days. Set false to stop
WHATSAPP_SCRUB_PROMPT_INJECTIONtrueStrip known prompt-injection patterns from incoming messages before Claude sees them
WHATSAPP_AUDIT_LOGtrueLog every tool call to audit.log
WHATSAPP_ENCRYPT_DBtrueEnable SQLCipher DB encryption; key in the platform secret store (macOS Keychain / Windows Credential Manager / libsecret)
WHATSAPP_DB_KEYemptyExplicit 64-hex-char SQLCipher key override (skips the platform store). Escape hatch for headless/CI/custom secret managers, and the recovery path when the secret store cannot be read — see below
The DB key and WHATSAPP_DB_KEY

With WHATSAPP_ENCRYPT_DB=true (the default), the bridge encrypts the message store with a 256-bit SQLCipher key kept in the platform secret store. The key lifecycle is deliberately conservative, because a wrong key silently orphans every stored message:

  • A fresh key is minted only when the secret store definitively answers "no such item" (macOS errSecItemNotFound, Windows ERROR_NOT_FOUND, libsecret clean miss) and no non-empty store database exists yet.
  • Any other failed read — locked keychain, no D-Bus session, revoked access — makes the bridge exit with an error instead of minting: the key may still exist, and overwriting it would make the encrypted store permanently undecryptable. The error names the fix (e.g. security unlock-keychain).
  • If the secret store has no key but a populated store database exists, the bridge also refuses to mint and asks you to supply the original key.

WHATSAPP_DB_KEY (64 hex chars = 32 bytes, e.g. openssl rand -hex 32) is the escape hatch for all of these: when set, it is used directly and the platform secret store is never touched. Use it for headless/CI machines, custom secret managers, restoring a store on a new machine, or booting while the platform store is unavailable.

Security

This MCP is the highest-trust component in your Claude stack because every WhatsApp message you receive flows through it. See SECURITY.md for the threat model, tool risk-tier classification, and the full list of hardening decisions.

Short version:

  • Bridge binds to 127.0.0.1 only, never 0.0.0.0
  • SQLite encrypted at rest with SQLCipher; key stored in the platform secret store (macOS Keychain / Windows Credential Manager / libsecret), with an explicit WHATSAPP_DB_KEY escape hatch
  • Every tool call logged to audit.log with 30-day retention
  • Send tools require an explicit confirm_send step between draft and delivery
  • Incoming message text passes through a prompt-injection scrubber before Claude sees it
  • whatsmeow pinned to a specific commit; upgrades require diff review
  • No telemetry, no external API calls by default

Status

v0.1.0, actively maintained.

Shipped: live-refreshing QR (in-place redraw on rotation, Windows-safe rendering, auto fresh batch on expiry) + pairing-code auth (typed 8-char code, Android + iOS) + headless auth API for supervisors, full read surface (chats, messages, contacts), accent-insensitive NFD-normalized search, LID alias resolution with backfill migration for legacy threads, Baileys-store import for one-shot history migration, vault-format markdown export, local whisper.cpp voice transcription, presence (typing, online, mark-read), text-send with mandatory confirm_send, reactions, reply-quotes, prompt-injection scrubber, SQLCipher-encrypted persistence with macOS Keychain key handling, audit log, CI security gates.

Not yet shipped: media-send (image, document), audio-message-send (FFmpeg-Opus path), group broadcast helpers.

See CHANGELOG.md for full history.

MCP Registry

Published on the official MCP Registry under io.github.adelaidasofia/whatsapp-mcp. Two live channels:

  • `.mcpb` bundle (canonical, recommended) — one-click install in Claude Desktop / Cursor / any MCPB-aware client. Published as a GitHub release artifact at releases/latest/download/whatsapp-mcp.mcpb. The release manifest carries the SHA256 for tamper detection.
  • PyPI package (adelaidasofia-whatsapp-mcp) — historical; available via uvx adelaidasofia-whatsapp-mcp for stdio-installer flows. The unprefixed names (whatsapp-mcp, whatsapp-mcp-server) are taken by unrelated projects on PyPI, hence the username-prefixed namespace.

The verification marker mcp-name: io.github.adelaidasofia/whatsapp-mcp is embedded in this README (HTML comment near the top) so the registry can verify package-to-server

冒頭だけを表示しています。続きはリポジトリで読めます