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

WhatsApp Web MCP Server

作者:mario-andreschakバージョン 1.2.0i★ 31iパソコンで動くリポジトリ ↗
レジストリ名io.github.mario-andreschak/mcp-whatsapp-web

インストール方法

What it does

WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts

  • Connects パソコンで動く
  • Account or key No key needed · 1 setting to fill in (BROWSER_EXECUTABLE_PATH)
  • Category チャット・メール

この順位の理由

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

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

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

インストール

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

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

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

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

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

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

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

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

設定を 1 項目入力 (BROWSER_EXECUTABLE_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

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

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

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

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

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

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

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

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

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

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

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

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

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • BROWSER_EXECUTABLE_PATH webjs 専用:ブラウザの実行ファイル。Chrome と Edge は自動検出されます。特定のブラウザを使う場合はこの値を設定してください。動画と GIF の送信には Chrome/Edge が必要です。
      英語の原文を見るwebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.

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

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

    SettingsDeveloperEdit Config

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

    {
      "mcpServers": {
        "whatsapp-web": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-whatsapp-web"
          ],
          "env": {
            "BROWSER_EXECUTABLE_PATH": "your-value"
          }
        }
      }
    }
  5. Claude を終了してもう一度開く

  6. 試してみる

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

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

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

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

  • WHATSAPP_BACKEND WhatsAppバックエンド:webjsは永続的なブラウザプロファイルを使用します。baileysはブラウザなしで接続し、別途ペアリングが必要です。
    英語の原文を見るWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · 初期値 webjs
  • BAILEYS_SESSION_DIR Baileys の認証情報および同期済み履歴のディレクトリ(既定値: /baileys-sessions)。単一のサーバープロセスが所有する、非公開の絶対パスを使用してください。
    英語の原文を見るBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL ログファイル(logs/mcp-whatsapp.log)のログレベル。
    英語の原文を見るLog level for the log file (logs/mcp-whatsapp.log)
    · 初期値 info
  • LOG_STDERR_LEVEL stderr のログレベル(ほとんどの MCP クライアントのログで表示されます)。
    英語の原文を見るLog level for stderr (visible in most MCP client logs)
    · 初期値 warn
  • WHATSAPP_HEADLESS webjs のみ: false に設定するとヘッドレスではなくブラウザウィンドウを表示します
    英語の原文を見るwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX webjs のみ: 必要とするコンテナ向けにブラウザのサンドボックスを明示的に無効にします。サンドボックスはデフォルトで有効です。
    英語の原文を見るwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · 初期値 false
  • WHATSAPP_SESSION_DIR webjs のみ: 永続的なブラウザプロファイルのディレクトリ(デフォルト: /whatsapp-sessions)
    英語の原文を見るwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER 電話番号によるペアリング:設定すると(記号を含まない国際形式、例:4915112345678)、起動時に QR コードの代わりに 8 文字のペアリングコードが stderr に出力されます。
    英語の原文を見るPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH ffmpeg バイナリのパス(ffmpeg-static npm パッケージによって自動インストールされた ffmpeg を上書きする場合にのみ必要)
    英語の原文を見るPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION webjs のみ: WhatsApp 側の更新でクライアントが動作しなくなった場合に、WhatsApp Web のバージョンを固定します。
    英語の原文を見るwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs のみ: 接続ヘルスチェックの間隔(ミリ秒)。0 以下で無効
    英語の原文を見るwebjs only: connection health check interval in milliseconds (<=0 disables)
    · 初期値 60000
  • TOOL_READY_TIMEOUT_MS ツール呼び出しが WhatsApp クライアントの準備完了を待つ時間。超過するとエラーになります。
    英語の原文を見るHow long tool calls wait for the WhatsApp client to become ready before erroring
    · 初期値 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST HTTP エンドポイントのバインドアドレス(公開しないこと。このエンドポイントは個人の WhatsApp アカウントを制御します)
    英語の原文を見るBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · 初期値 127.0.0.1
  • MCP_OAUTH HTTP エンドポイントで OAuth を有効にします。/mcp には bearer トークンが必要で、クライアントは WhatsApp QR コード/ペアリングフォームを表示するブラウザページで認証します
    英語の原文を見るEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

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

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

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

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

代わりにできること

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

  • 設定を 1 項目入力 (BROWSER_EXECUTABLE_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 設定を 1 項目入力 (BROWSER_EXECUTABLE_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 設定を 1 項目入力 (BROWSER_EXECUTABLE_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 設定を 1 項目入力 (BROWSER_EXECUTABLE_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

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

設定を 1 項目入力 (BROWSER_EXECUTABLE_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

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

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

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

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

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

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

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

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

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

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

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • BROWSER_EXECUTABLE_PATH webjs 専用:ブラウザの実行ファイル。Chrome と Edge は自動検出されます。特定のブラウザを使う場合はこの値を設定してください。動画と GIF の送信には Chrome/Edge が必要です。
      英語の原文を見るwebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.

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

  3. ターミナルを開く

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

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

    claude mcp add --scope user whatsapp-web --env BROWSER_EXECUTABLE_PATH=your-value -- npx -y mcp-whatsapp-web
  5. Claude Code で /mcp と入力

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

  6. 試してみる

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

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

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

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

  • WHATSAPP_BACKEND WhatsAppバックエンド:webjsは永続的なブラウザプロファイルを使用します。baileysはブラウザなしで接続し、別途ペアリングが必要です。
    英語の原文を見るWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · 初期値 webjs
  • BAILEYS_SESSION_DIR Baileys の認証情報および同期済み履歴のディレクトリ(既定値: /baileys-sessions)。単一のサーバープロセスが所有する、非公開の絶対パスを使用してください。
    英語の原文を見るBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL ログファイル(logs/mcp-whatsapp.log)のログレベル。
    英語の原文を見るLog level for the log file (logs/mcp-whatsapp.log)
    · 初期値 info
  • LOG_STDERR_LEVEL stderr のログレベル(ほとんどの MCP クライアントのログで表示されます)。
    英語の原文を見るLog level for stderr (visible in most MCP client logs)
    · 初期値 warn
  • WHATSAPP_HEADLESS webjs のみ: false に設定するとヘッドレスではなくブラウザウィンドウを表示します
    英語の原文を見るwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX webjs のみ: 必要とするコンテナ向けにブラウザのサンドボックスを明示的に無効にします。サンドボックスはデフォルトで有効です。
    英語の原文を見るwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · 初期値 false
  • WHATSAPP_SESSION_DIR webjs のみ: 永続的なブラウザプロファイルのディレクトリ(デフォルト: /whatsapp-sessions)
    英語の原文を見るwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER 電話番号によるペアリング:設定すると(記号を含まない国際形式、例:4915112345678)、起動時に QR コードの代わりに 8 文字のペアリングコードが stderr に出力されます。
    英語の原文を見るPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH ffmpeg バイナリのパス(ffmpeg-static npm パッケージによって自動インストールされた ffmpeg を上書きする場合にのみ必要)
    英語の原文を見るPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION webjs のみ: WhatsApp 側の更新でクライアントが動作しなくなった場合に、WhatsApp Web のバージョンを固定します。
    英語の原文を見るwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs のみ: 接続ヘルスチェックの間隔(ミリ秒)。0 以下で無効
    英語の原文を見るwebjs only: connection health check interval in milliseconds (<=0 disables)
    · 初期値 60000
  • TOOL_READY_TIMEOUT_MS ツール呼び出しが WhatsApp クライアントの準備完了を待つ時間。超過するとエラーになります。
    英語の原文を見るHow long tool calls wait for the WhatsApp client to become ready before erroring
    · 初期値 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST HTTP エンドポイントのバインドアドレス(公開しないこと。このエンドポイントは個人の WhatsApp アカウントを制御します)
    英語の原文を見るBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · 初期値 127.0.0.1
  • MCP_OAUTH HTTP エンドポイントで OAuth を有効にします。/mcp には bearer トークンが必要で、クライアントは WhatsApp QR コード/ペアリングフォームを表示するブラウザページで認証します
    英語の原文を見るEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

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

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

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

設定を 1 項目入力 (BROWSER_EXECUTABLE_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

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

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

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

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

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

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

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

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

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

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

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • BROWSER_EXECUTABLE_PATH webjs 専用:ブラウザの実行ファイル。Chrome と Edge は自動検出されます。特定のブラウザを使う場合はこの値を設定してください。動画と GIF の送信には Chrome/Edge が必要です。
      英語の原文を見るwebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.

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

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

    Cursor で開く

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

  4. キーを入力

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

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

  6. 試してみる

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

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

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

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

  • WHATSAPP_BACKEND WhatsAppバックエンド:webjsは永続的なブラウザプロファイルを使用します。baileysはブラウザなしで接続し、別途ペアリングが必要です。
    英語の原文を見るWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · 初期値 webjs
  • BAILEYS_SESSION_DIR Baileys の認証情報および同期済み履歴のディレクトリ(既定値: /baileys-sessions)。単一のサーバープロセスが所有する、非公開の絶対パスを使用してください。
    英語の原文を見るBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL ログファイル(logs/mcp-whatsapp.log)のログレベル。
    英語の原文を見るLog level for the log file (logs/mcp-whatsapp.log)
    · 初期値 info
  • LOG_STDERR_LEVEL stderr のログレベル(ほとんどの MCP クライアントのログで表示されます)。
    英語の原文を見るLog level for stderr (visible in most MCP client logs)
    · 初期値 warn
  • WHATSAPP_HEADLESS webjs のみ: false に設定するとヘッドレスではなくブラウザウィンドウを表示します
    英語の原文を見るwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX webjs のみ: 必要とするコンテナ向けにブラウザのサンドボックスを明示的に無効にします。サンドボックスはデフォルトで有効です。
    英語の原文を見るwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · 初期値 false
  • WHATSAPP_SESSION_DIR webjs のみ: 永続的なブラウザプロファイルのディレクトリ(デフォルト: /whatsapp-sessions)
    英語の原文を見るwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER 電話番号によるペアリング:設定すると(記号を含まない国際形式、例:4915112345678)、起動時に QR コードの代わりに 8 文字のペアリングコードが stderr に出力されます。
    英語の原文を見るPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH ffmpeg バイナリのパス(ffmpeg-static npm パッケージによって自動インストールされた ffmpeg を上書きする場合にのみ必要)
    英語の原文を見るPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION webjs のみ: WhatsApp 側の更新でクライアントが動作しなくなった場合に、WhatsApp Web のバージョンを固定します。
    英語の原文を見るwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs のみ: 接続ヘルスチェックの間隔(ミリ秒)。0 以下で無効
    英語の原文を見るwebjs only: connection health check interval in milliseconds (<=0 disables)
    · 初期値 60000
  • TOOL_READY_TIMEOUT_MS ツール呼び出しが WhatsApp クライアントの準備完了を待つ時間。超過するとエラーになります。
    英語の原文を見るHow long tool calls wait for the WhatsApp client to become ready before erroring
    · 初期値 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST HTTP エンドポイントのバインドアドレス(公開しないこと。このエンドポイントは個人の WhatsApp アカウントを制御します)
    英語の原文を見るBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · 初期値 127.0.0.1
  • MCP_OAUTH HTTP エンドポイントで OAuth を有効にします。/mcp には bearer トークンが必要で、クライアントは WhatsApp QR コード/ペアリングフォームを表示するブラウザページで認証します
    英語の原文を見るEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

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

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

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

設定を 1 項目入力 (BROWSER_EXECUTABLE_PATH) · 先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

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

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

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

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

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

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

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

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

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

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

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • BROWSER_EXECUTABLE_PATH webjs 専用:ブラウザの実行ファイル。Chrome と Edge は自動検出されます。特定のブラウザを使う場合はこの値を設定してください。動画と GIF の送信には Chrome/Edge が必要です。
      英語の原文を見るwebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.

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

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

    VS Code で開く

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

  4. キーを入力

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

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

  6. 試してみる

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

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

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

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

  • WHATSAPP_BACKEND WhatsAppバックエンド:webjsは永続的なブラウザプロファイルを使用します。baileysはブラウザなしで接続し、別途ペアリングが必要です。
    英語の原文を見るWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · 初期値 webjs
  • BAILEYS_SESSION_DIR Baileys の認証情報および同期済み履歴のディレクトリ(既定値: /baileys-sessions)。単一のサーバープロセスが所有する、非公開の絶対パスを使用してください。
    英語の原文を見るBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL ログファイル(logs/mcp-whatsapp.log)のログレベル。
    英語の原文を見るLog level for the log file (logs/mcp-whatsapp.log)
    · 初期値 info
  • LOG_STDERR_LEVEL stderr のログレベル(ほとんどの MCP クライアントのログで表示されます)。
    英語の原文を見るLog level for stderr (visible in most MCP client logs)
    · 初期値 warn
  • WHATSAPP_HEADLESS webjs のみ: false に設定するとヘッドレスではなくブラウザウィンドウを表示します
    英語の原文を見るwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX webjs のみ: 必要とするコンテナ向けにブラウザのサンドボックスを明示的に無効にします。サンドボックスはデフォルトで有効です。
    英語の原文を見るwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · 初期値 false
  • WHATSAPP_SESSION_DIR webjs のみ: 永続的なブラウザプロファイルのディレクトリ(デフォルト: /whatsapp-sessions)
    英語の原文を見るwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER 電話番号によるペアリング:設定すると(記号を含まない国際形式、例:4915112345678)、起動時に QR コードの代わりに 8 文字のペアリングコードが stderr に出力されます。
    英語の原文を見るPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH ffmpeg バイナリのパス(ffmpeg-static npm パッケージによって自動インストールされた ffmpeg を上書きする場合にのみ必要)
    英語の原文を見るPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION webjs のみ: WhatsApp 側の更新でクライアントが動作しなくなった場合に、WhatsApp Web のバージョンを固定します。
    英語の原文を見るwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs のみ: 接続ヘルスチェックの間隔(ミリ秒)。0 以下で無効
    英語の原文を見るwebjs only: connection health check interval in milliseconds (<=0 disables)
    · 初期値 60000
  • TOOL_READY_TIMEOUT_MS ツール呼び出しが WhatsApp クライアントの準備完了を待つ時間。超過するとエラーになります。
    英語の原文を見るHow long tool calls wait for the WhatsApp client to become ready before erroring
    · 初期値 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST HTTP エンドポイントのバインドアドレス(公開しないこと。このエンドポイントは個人の WhatsApp アカウントを制御します)
    英語の原文を見るBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · 初期値 127.0.0.1
  • MCP_OAUTH HTTP エンドポイントで OAuth を有効にします。/mcp には bearer トークンが必要で、クライアントは WhatsApp QR コード/ペアリングフォームを表示するブラウザページで認証します
    英語の原文を見るEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

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

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

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

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

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

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

パソコンにインストール

Claude Code

claude mcp add --scope user whatsapp-web --env BROWSER_EXECUTABLE_PATH=your-value -- npx -y mcp-whatsapp-web

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "whatsapp-web": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "your-value"
      }
    }
  }
}

自分で入力する値

  • WHATSAPP_BACKEND env
    WhatsAppバックエンド:webjsは永続的なブラウザプロファイルを使用します。baileysはブラウザなしで接続し、別途ペアリングが必要です。
    英語の原文を見るWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
  • BAILEYS_SESSION_DIR env
    Baileys の認証情報および同期済み履歴のディレクトリ(既定値: /baileys-sessions)。単一のサーバープロセスが所有する、非公開の絶対パスを使用してください。
    英語の原文を見るBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL env
    ログファイル(logs/mcp-whatsapp.log)のログレベル。
    英語の原文を見るLog level for the log file (logs/mcp-whatsapp.log)
  • LOG_STDERR_LEVEL env
    stderr のログレベル(ほとんどの MCP クライアントのログで表示されます)。
    英語の原文を見るLog level for stderr (visible in most MCP client logs)
  • WHATSAPP_HEADLESS env
    webjs のみ: false に設定するとヘッドレスではなくブラウザウィンドウを表示します
    英語の原文を見るwebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX env
    webjs のみ: 必要とするコンテナ向けにブラウザのサンドボックスを明示的に無効にします。サンドボックスはデフォルトで有効です。
    英語の原文を見るwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
  • BROWSER_EXECUTABLE_PATH 必須 env
    webjs 専用:ブラウザの実行ファイル。Chrome と Edge は自動検出されます。特定のブラウザを使う場合はこの値を設定してください。動画と GIF の送信には Chrome/Edge が必要です。
    英語の原文を見るwebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.
  • WHATSAPP_SESSION_DIR env
    webjs のみ: 永続的なブラウザプロファイルのディレクトリ(デフォルト: /whatsapp-sessions)
    英語の原文を見るwebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER env
    電話番号によるペアリング:設定すると(記号を含まない国際形式、例:4915112345678)、起動時に QR コードの代わりに 8 文字のペアリングコードが stderr に出力されます。
    英語の原文を見るPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH env
    ffmpeg バイナリのパス(ffmpeg-static npm パッケージによって自動インストールされた ffmpeg を上書きする場合にのみ必要)
    英語の原文を見るPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION env
    webjs のみ: WhatsApp 側の更新でクライアントが動作しなくなった場合に、WhatsApp Web のバージョンを固定します。
    英語の原文を見るwebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS env
    webjs のみ: 接続ヘルスチェックの間隔(ミリ秒)。0 以下で無効
    英語の原文を見るwebjs only: connection health check interval in milliseconds (<=0 disables)
  • TOOL_READY_TIMEOUT_MS env
    ツール呼び出しが WhatsApp クライアントの準備完了を待つ時間。超過するとエラーになります。
    英語の原文を見るHow long tool calls wait for the WhatsApp client to become ready before erroring
  • MCP_HTTP_PORT env
    When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST env
    HTTP エンドポイントのバインドアドレス(公開しないこと。このエンドポイントは個人の WhatsApp アカウントを制御します)
    英語の原文を見るBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
  • MCP_OAUTH env
    HTTP エンドポイントで OAuth を有効にします。/mcp には bearer トークンが必要で、クライアントは WhatsApp QR コード/ペアリングフォームを表示するブラウザページで認証します
    英語の原文を見るEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

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

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

ひと目でわかる

週あたりのダウンロードi
76/週
接続方法
パソコンで動く
最新バージョンi
1.2.0
レジストリ公開日i
2026年9月6日
コードの最終更新i
2026年11月11日
作者
mario-andreschak
パッケージ
npm: mcp-whatsapp-web
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。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アカウント mario-andreschak で確認済みです

  • ✓ 合格

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

    コードの最終更新:8 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

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

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

  • – 対象外

    OAuthでサインイン

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

  • … 未チェック

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

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

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

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

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

確認していること → · JSON

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

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

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

話し合い

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

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

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

ログインして投稿

ユーザーレビュー

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

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

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

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

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

よくある質問

WhatsApp Web MCP Serverは安全ですか?

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

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

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

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

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

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

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

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

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

代わりに使えるものは?

同じカテゴリには: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 Web MCP Server
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、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Very Important

Automation of Whatsapp Messages without Meta (Business-)API is against WhatsApp' Terms of Service! You take full responsibility for everything you do with this MCP-Server. It is possible that your account will be flagged/restricted.

MCP WhatsApp Web (TypeScript)

A Model Context Protocol (MCP) server for WhatsApp Web, implemented in TypeScript. This project is a TypeScript port of the original whatsapp-mcp repository.

With this MCP server, you can:

  • Search and read your personal WhatsApp messages (including media)
  • Search your contacts
  • Send messages to individuals or groups
  • Send and receive media files (images, videos, documents, audio)

Features

  • TypeScript Implementation: Fully typed codebase for better developer experience and code reliability
  • Selectable WhatsApp Backend: Uses whatsapp-web.js by default, with an optional Baileys backend that runs without a browser
  • MCP Server: Implements the Model Context Protocol for seamless integration with AI assistants
  • Media Support: Send and receive images, videos, documents, and audio messages
  • Webhooks (Baileys): signed notifications for new messages and for incoming calls, including who is calling
  • Multiple Transport Options: Supports stdio and Streamable HTTP transports — even both at once from a single process (start with stdio and set MCP_HTTP_PORT to additionally expose http://127.0.0.1: /mcp, or run HTTP-only with --http)
  • Flexible Authentication: QR code (as an MCP image tool), pairing code (request_pairing_code tool, or automatically printed to stderr at startup via WHATSAPP_PAIRING_PHONE_NUMBER), and an optional OAuth flow for HTTP clients (MCP_OAUTH=true) where the browser authorization page shows the WhatsApp QR code — unlinking WhatsApp revokes tokens so clients automatically re-authenticate

Architecture

This MCP server consists of:

  1. TypeScript MCP Server: Implements the Model Context Protocol to provide standardized tools for AI assistants to interact with WhatsApp
  2. WhatsApp Backend: A shared service interface selects web.js/Puppeteer or Baileys/WebSocket, handles authentication, and manages message sending/receiving
  3. Tool Implementations: Provides various tools for contacts, chats, messages, media, and authentication

Prerequisites

  • Node.js >= 22.0.0 (Node 22 or 24 recommended for the Baileys SQLite dependency)
  • npm or yarn
  • For the default webjs backend: Google Chrome or Microsoft Edge (auto-detected; needed for video/GIF codec support; other operations can use Puppeteer's bundled Chromium)
  • For baileys: install optional dependencies, including the native better-sqlite3 module. No Chrome, Edge, or Chromium is needed at runtime.

FFmpeg is bundled automatically via the ffmpeg-static npm package — no manual installation needed. You can point the FFMPEG_PATH environment variable at your own binary to override it.

Installation

npx
   npx mcp-whatsapp-web
Manual Installation
  1. Clone this repository
   git clone https://github.com/mario-andreschak/mcp-whatsapp-web.git

cd mcp-whatsapp-web

  1. Install dependencies
   npm install
  1. Build the project
   npm run build
  1. Configure environment variables (optional)

Copy the example environment file and modify as needed:

   cp .env.example .env

You can select the backend with WHATSAPP_BACKEND, adjust logging levels, pin the WhatsApp Web version, or override the auto-detected browser (BROWSER_EXECUTABLE_PATH) and ffmpeg binary (FFMPEG_PATH). WHATSAPP_HEADLESS=false shows the web.js browser window, and WHATSAPP_SESSION_DIR relocates its persistent profile. Without these settings the sign-in is kept in a fixed place for your user account, so it no longer matters which folder a program starts the server from (see Keeping the link).

Choosing a backend

WHATSAPP_BACKEND=webjs is the default and preserves existing sessions and MCP tool names. It uses a dedicated persistent LocalAuth profile, not your personal Chrome profile. It now keeps the browser's native user agent and graphics defaults, omits Puppeteer's automation banner flag, and leaves the browser sandbox enabled. Containers that require disabling the sandbox can explicitly set WHATSAPP_NO_SANDBOX=true. These settings do not guarantee that automation is undetectable.

To use the optional Baileys backend, set these variables in your MCP client configuration or .env, then restart the server:

WHATSAPP_BACKEND=baileys

Optional: where the sign-in lives. Leave it out to use the standard place.

#BAILEYS_SESSION_DIR=C:/path/to/your/baileys-sessions

BAILEYS_SESSION_DIR is optional; without it the sign-in lives in the standard place described in Keeping the link. Pair this backend separately with get_qr_code or request_pairing_code. The existing WHATSAPP_PAIRING_PHONE_NUMBER option also works. Baileys cannot reuse the web.js browser profile. You can switch back to webjs and resume its existing session.

Baileys links as a Chrome device (shown as "Chrome (Windows)" or "Chrome (Mac OS)" under Linked devices). WhatsApp currently ends new links that claim to be the Desktop app with status 428 ("Connection Terminated") before a QR code appears. Desktop would request the full chat history; Chrome receives recent history, and live messages are stored from then on. BAILEYS_BROWSER=Desktop restores the old behaviour. At startup the backend also looks up the current WhatsApp Web version from web.whatsapp.com, because WhatsApp refuses clients that report an outdated one; WA_WEB_VERSION pins it, and a failed lookup falls back to the version bundled with Baileys.

Baileys and SQLite are pinned optional dependencies installed by normal npm install. If your package manager omitted them, run npm install --include=optional. SQLite uses a native addon; a supported prebuilt binary or a local native build toolchain is required. To avoid downloading Chromium when installing for Baileys or an existing system browser, use:

$env:PUPPETEER_SKIP_DOWNLOAD = 'true'

npm install --include=optional npm run build

On macOS/Linux, the equivalent installation command is PUPPETEER_SKIP_DOWNLOAD=true npm install --include=optional. Selecting Baileys loads only its driver and never starts or cleans up browser processes. An unavailable backend produces an error; it never silently switches drivers or retries a send through another backend.

Baileys sessions and history
  • Credentials, Signal keys, contacts, chats and messages persist in session.sqlite inside the sign-in folder. Keep the whole folder private and out of version control. Only one running server may own a sign-in folder. Use separate folders for independent accounts.
  • Normal shutdown and lost connections keep the sign-in. Only a clear "this device was removed" from WhatsApp, or the logout tool, ends it; both revoke the OAuth access tokens. Baileys HTTP OAuth state is stored separately from web.js in oauth-store.json inside the sign-in folder.
  • get_backend_status reports the active backend, authentication, stored record counts and history synchronization state. Being connected does not mean history has finished arriving. An available history state means local data is available, not that WhatsApp supplied a complete archive.
  • Contact and history tools query the local synchronized store. Initial full-history sync is requested and can take time on large accounts. list_messages may request up to 100 additional older messages when a known chat has fewer than requested, with a bounded wait and a per-chat cooldown. Late history batches are persisted for subsequent queries. WhatsApp may still supply only part of an account's history.
  • Treat returned message IDs as opaque and use IDs from the active backend. Legacy @c.us phone-number inputs, @s.whatsapp.net, groups and @lid identifiers are supported; known LID/phone mappings are persisted. Message IDs from web.js cannot be passed to Baileys or vice versa.
  • Text, media, downloads, voice notes and the existing authentication tools use the same MCP interface. Voice-note inputs must be local files or base64; FFmpeg converts them to mono Opus/Ogg before sending. If conversion fails, the tool reports an error without sending a different message type.

The Baileys backend is opt-in and pinned to 7.0.0-rc14. Review upstream changes before upgrading, especially authentication and message-format migrations. See the Baileys documentation and release history.

Keeping the link

You should only need to scan the QR code once. After that the server stays linked, even when it is restarted, started by a different program, or loses its internet connection for a while.

Where the sign-in lives. By default the sign-in is kept in one fixed place for your user account, whatever folder a program starts the server from:

SystemBaileysweb.js
Windows%LOCALAPPDATA%\mcp-whatsapp-web\baileys-sessions%LOCALAPPDATA%\mcp-whatsapp-web\whatsapp-sessions
macOS~/Library/Application Support/mcp-whatsapp-web/baileys-sessions~/Library/Application Support/mcp-whatsapp-web/whatsapp-sessions
Linux~/.local/share/mcp-whatsapp-web/baileys-sessions (or under $XDG_DATA_HOME)~/.local/share/mcp-whatsapp-web/whatsapp-sessions
  • If you set BAILEYS_SESSION_DIR (or WHATSAPP_SESSION_DIR for web.js), that folder is always used.
  • Older versions kept the sign-in in a baileys-sessions (or whatsapp-sessions) folder inside the folder the server was started from. If such a sign-in exists and no folder is set, the server keeps using it and says so in its log.
  • At start the log says which folder is used and whether it holds a sign-in. get_backend_status shows it too, as connection.signInFolder.

Moving the sign-in. Stop every program that runs the server, move the whole folder (all files in it) to the new place, then either put it in the standard place above or point BAILEYS_SESSION_DIR at it, and start the server again.

Using it from more than one program. Two programs cannot share one sign-in at the same time. The second one waits and takes over by itself when the first one closes. If both should run at the same time, give the second program its own folder (BAILEYS_SESSION_DIR) and link it as its own device by scanning a new QR code. WhatsApp allows several linked devices per phone. Never copy a sign-in folder to a second program: the two copies would keep pushing each other off.

When the connection drops. The server reconnects by itself: quickly at first, then every five minutes for as long as it runs, so it recovers on its own when the network comes back. Asking for WhatsApp (for example check_auth_status or any tool) makes it try again at once. get_backend_status tells you in plain words what is going on: connection.state is linked, reconnecting, waiting_for_link, waiting_for_other_program or stopped, with since, lastReason and the next attempt.

What really ends a link. Only these need a new QR code:

  • The device was removed under Settings > Linked devices on the phone, or with the logout tool.
  • The phone was offline for a long time (WhatsApp ends linked devices after about 14 days without the phone).
  • WhatsApp itself ends the link, for examp

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