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

Relay for WhatsApp

作者:viaanshetty3-debugバージョン 1.2.0i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.viaanshetty3-debug/relay-whatsapp-mcp

インストール方法

できること

Your WhatsApp as 38 MCP tools: read, search, send and media across accounts, self-hosted.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー キー不要
  • カテゴリ チャット・メール

この順位の理由

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

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

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

インストール

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

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

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

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

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

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

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

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

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

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

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

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

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

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

    {
      "mcpServers": {
        "relay-whatsapp": {
          "command": "npx",
          "args": [
            "-y",
            "relay-whatsapp-mcp",
            "mcp"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

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

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

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

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

  • RELAY_HOME Relay の .env と WhatsApp セッションを含むフォルダー(既定値:/.relay-whatsapp-mcp)。先に npx relay-whatsapp-mcp setup と start を実行してください
    英語の原文を見るFolder with Relay's .env and WhatsApp session (default: ~/.relay-whatsapp-mcp). Run `npx relay-whatsapp-mcp setup` and `start` first.
  • BRIDGE_URL Address of the running Relay bridge (default: http://127.0.0.1:8787)

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

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

ChatGPT はまだ Relay for WhatsApp につなげません

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

代わりにできること

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

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

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

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

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

先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

このパソコンの Claude Code に MCP server Relay for WhatsApp を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user relay-whatsapp -- npx -y relay-whatsapp-mcp mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、Relay for WhatsApp のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. ターミナルを開く

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

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

    claude mcp add --scope user relay-whatsapp -- npx -y relay-whatsapp-mcp mcp
  4. Claude Code で /mcp と入力

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

  5. 試してみる

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

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

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

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

  • RELAY_HOME Relay の .env と WhatsApp セッションを含むフォルダー(既定値:/.relay-whatsapp-mcp)。先に npx relay-whatsapp-mcp setup と start を実行してください
    英語の原文を見るFolder with Relay's .env and WhatsApp session (default: ~/.relay-whatsapp-mcp). Run `npx relay-whatsapp-mcp setup` and `start` first.
  • BRIDGE_URL Address of the running Relay bridge (default: http://127.0.0.1:8787)

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

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

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

先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

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

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. このボタンで Cursor を開く

    Cursor で開く

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

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

  4. 試してみる

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

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

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

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

  • RELAY_HOME Relay の .env と WhatsApp セッションを含むフォルダー(既定値:/.relay-whatsapp-mcp)。先に npx relay-whatsapp-mcp setup と start を実行してください
    英語の原文を見るFolder with Relay's .env and WhatsApp session (default: ~/.relay-whatsapp-mcp). Run `npx relay-whatsapp-mcp setup` and `start` first.
  • BRIDGE_URL Address of the running Relay bridge (default: http://127.0.0.1:8787)

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

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

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

先にパソコンへ Node.js を入れてください(1 回だけ)

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

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

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

このメッセージにあなたのキーは含まれません。キーが必要な場合は、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. このボタンで VS Code を開く

    VS Code で開く

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

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

  4. 試してみる

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

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

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

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

  • RELAY_HOME Relay の .env と WhatsApp セッションを含むフォルダー(既定値:/.relay-whatsapp-mcp)。先に npx relay-whatsapp-mcp setup と start を実行してください
    英語の原文を見るFolder with Relay's .env and WhatsApp session (default: ~/.relay-whatsapp-mcp). Run `npx relay-whatsapp-mcp setup` and `start` first.
  • BRIDGE_URL Address of the running Relay bridge (default: http://127.0.0.1:8787)

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

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

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

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

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

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

パソコンにインストール

Claude Code

claude mcp add --scope user relay-whatsapp -- npx -y relay-whatsapp-mcp mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "relay-whatsapp": {
      "command": "npx",
      "args": [
        "-y",
        "relay-whatsapp-mcp",
        "mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "relay-whatsapp": {
      "command": "npx",
      "args": [
        "-y",
        "relay-whatsapp-mcp",
        "mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "relay-whatsapp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "relay-whatsapp-mcp",
        "mcp"
      ]
    }
  }
}

自分で入力する値

  • RELAY_HOME env
    Relay の .env と WhatsApp セッションを含むフォルダー(既定値:/.relay-whatsapp-mcp)。先に npx relay-whatsapp-mcp setup と start を実行してください
    英語の原文を見るFolder with Relay's .env and WhatsApp session (default: ~/.relay-whatsapp-mcp). Run `npx relay-whatsapp-mcp setup` and `start` first.
  • BRIDGE_URL env
    Address of the running Relay bridge (default: http://127.0.0.1:8787)

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

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

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
1.2.0
レジストリ公開日i
2026年11月15日
コードの最終更新i
2026年11月19日
作者
viaanshetty3-debug
パッケージ
npm: relay-whatsapp-mcp
ウェブサイト
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月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

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

  • ✓ 合格

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

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

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

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

  • – 対象外

    OAuthでサインイン

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

  • … 未チェック

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

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

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

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

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

確認していること → · JSON

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

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

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

話し合い

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

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

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

ログインして投稿

ユーザーレビュー

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

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

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

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

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

よくある質問

Relay for WhatsAppは安全ですか?

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

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

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

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

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

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

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

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

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/週★ 13956 日前更新

パソコンでもクラウドでも✓ 提供元 · 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初期★ 3524 日前更新

クラウドで動く✓ 提供元 · kernelcad.com
似たものと比べる
これ
Relay for WhatsApp
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、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Relay

Your WhatsApp, as 38 MCP tools for Claude and ChatGPT: self-hosted, failover-ready, and free to run.

Demo mode with sample chats ( npx relay-whatsapp-mcp demo ). Your real chats never leave your computer.

Ask your AI things like:

  • *"What did I miss in the family group today? Summarise it in three lines."*
  • *"Find the address Sam sent me last month."*
  • *"Transcribe the voice note from Priya and draft a reply. Don't send it yet."*
  • *"Check my Work WhatsApp for anything urgent."*

Why people use it: free and self-hosted, works with Claude and ChatGPT, several WhatsApp accounts in one place, nothing sent without you asking, and a standby that takes over in seconds if your computer sleeps.

[💬 Ask Relay AI (Free Live Assistant)](https://relay-docs-ai.viaan-mcp.workers.dev): a help page with a searchable troubleshooting guide and an AI chat sidebar for questions about setup, failover, the 38 tools or security. It's free, with no login or key, and each visitor's chat stays private in their own browser. Answers come from these docs via Google Gemini and can be wrong. If Gemini isn't available, it answers from a docs search instead.

Quickstart with npx

Needs Node.js 22.13+. Nothing to clone:

npx relay-whatsapp-mcp

Your browser opens http://127.0.0.1:8787. Create your account (Google, GitHub, or email), click Connect WhatsApp, and scan the QR code from WhatsApp → Settings → Linked devices. Then open Connections and click Add to Claude Desktop (or Add to Claude Code), and restart Claude. That's it: from then on Claude starts Relay by itself when it needs it. The same from a terminal:

npx relay-whatsapp-mcp connect

Prefer to set it up by hand?

Claude Code: claude mcp add whatsapp -- npx -y relay-whatsapp-mcp mcp. Claude Desktop, in claude_desktop_config.json:

{ "mcpServers": { "whatsapp": { "command": "npx", "args": ["-y", "relay-whatsapp-mcp", "mcp"] } } }

Try it without a WhatsApp account first: npx relay-whatsapp-mcp demo (sample chats). npx relay-whatsapp-mcp doctor checks everything; help lists all commands. Your private files (.env, the WhatsApp session, data) live in ~/.relay-whatsapp-mcp, never inside npm's folders; set RELAY_HOME to change that. If Claude Desktop reports that npx was not found, put the full path from which npx (where npx on Windows) in "command". To run Relay at login, install it permanently with npm install -g relay-whatsapp-mcp, then run relay-whatsapp-mcp autostart. The optional Cloudflare relay (Claude on your phone, failover) is deployed from a clone: see the 5-minute quickstart.

A real run on Cloudflare's free plan with two demo bridges (fake chats), replayed from the recorded terminal output; the waiting part is sped up 2×. The client calls Relay through the same doorway Claude uses.

Relay links your own WhatsApp account as a linked device (like WhatsApp Web) on a computer you control and exposes it to AI assistants through the Model Context Protocol. Ask Claude to summarise a group chat, find the address a friend sent last month, transcribe a voice note, or draft and send a reply. It acts only when you ask it to.

   ┌──────────┐                 ┌──────────┐

│ ChatGPT │ │ Claude │ claude.ai · Desktop · Code · mobile └────┬─────┘ └────┬─────┘ │ owner sign-in │ x-api-key │ ┌────────▼──────────┐ │ │ Cloudflare doorway│ claude-proxy/ (free Worker) │ └────────┬──────────┘ │ │ client key ┌────▼─────────────────────────────▼──────────┐ │ Relay (relay-worker/) │ owner-only MCP endpoint │ queue encrypted at rest · AES-256-GCM │ Worker + D1 (free tier) └───────────────┬────────────────┬─────────────┘ outbound │ long poll │ long poll outbound only: HTTPS only │ │ no open ports at home ┌───────────────▼─────┐ ┌──────▼──────────────────┐ │ Primary bridge │ │ Standby bridge │ │ macOS·Linux·Windows│ │ macOS·Linux·Windows │ │ WhatsApp linked │ │ (optional) its own │ │ device #1 │ │ linked device #2 │ └─────────────────────┘ └─────────────────────────┘ WhatsApp keys and message history never leave these machines

You don't need the hosted part: a single bridge with Claude Desktop or Claude Code on the same computer works with no hosting at all.


Why Relay

38 WhatsApp tools, not just "send a message"

Read and search history, follow live events with a durable cursor, download and analyse attachments up to 500 MB (local transcription, PDF/OCR, video frames, optional local vision), send and reply, edit, delete, react, forward, polls, drafts, scheduled messages, groups and presence. Full reference ↓

Failover in about 4–6 seconds, never sending twice
  • Run an optional standby bridge on a second computer. If the primary sleeps or loses its connection, the standby starts serving after about 4–6 seconds of silence (about 7–9 s with the free-tier setting), then steps back when the primary returns.
  • Reads in progress are handed over. If a device goes silent in the middle of a read-only request, the relay re-queues that request for the other device.
  • Writes are never re-queued or retried automatically (send, edit, delete, react, groups and so on). Each queued request is claimed by exactly one device (an atomic UPDATE … WHERE status='queued'). A write that times out is reported as *may have executed*, with an instruction to check the chat instead of retrying. send_message also accepts a requestId, so a retry with the same ID is de-duplicated, and an interrupted scheduled send is marked *uncertain* rather than re-sent.
Built-in defences against indirect prompt injection

Incoming WhatsApp content is written by other people, so Relay treats it as data, never instructions:

  • Every MCP server Relay exposes (local, remote and relay) carries server instructions saying that message text, attachments and contact names are untrusted and must not be followed as instructions.
  • Attachment and analysis results are labelled as untrusted content.
  • Writes happen only through explicit, schema-validated tool calls. READ_ONLY=true turns off every outgoing action, and ALLOWED_CHATS limits which chats the AI can see at all.
  • Reading never sends read receipts, so an AI browsing your chats doesn't reveal that you've seen them.

These measures reduce the risk; they can't make a language model immune to manipulation. See SECURITY.md.

Cross-platform, runs on free tiers
  • The bridge is plain Node.js, so it runs on macOS, Linux and Windows. It also runs on Android (Termux) as an experimental option.
  • Auto-start templates for launchd, systemd and Task Scheduler, installed with one command.
  • No AI API key, no subscription and no per-message fees. The relay and the Claude doorway both run on Cloudflare's free Workers and D1 plans. See free-tier budget for the numbers.

5-minute quickstart

You need: Node.js 22.13+ and WhatsApp on your phone.

git clone https://github.com/viaanshetty3-debug/relay-whatsapp-mcp.git && cd relay-whatsapp-mcp

npm install npm run setup

npm run setup (macOS, Linux and Windows):

  1. generates strong random keys (32 bytes each, from crypto.randomBytes),
  2. asks for your relay and Cloudflare doorway URLs. Both are optional: press Enter to stay local-only,
  3. writes a private .env (and, if you use them, relay-worker/.secrets.json and claude-proxy/.secrets.json for deploying),
  4. prints ready-to-paste configs for Claude Desktop, Claude Code and ChatGPT.

Then link WhatsApp:

npm start

Open http://127.0.0.1:8787 and create your account (see Dashboard sign-in). Then choose Connect WhatsApp, and on your phone go to WhatsApp → Settings → Linked devices → Link a device and scan the QR code. Paste the printed config into your AI client and ask it:

Check my WhatsApp connection and list my 3 most recent chats. Don't send anything.

To see your configs again later: npm run setup -- --print. If anything seems off, run `npm run doctor`. In a few seconds it checks Node, your .env, the bridge and WhatsApp session, the relay and the Claude doorway, and says what to fix.

Several WhatsApp profiles

One Relay can hold up to 10 WhatsApp accounts, for example personal and work. In the dashboard, open the profile menu next to the connection status and choose + Add another WhatsApp…, name it, and scan the QR code with that phone. Switch between profiles from the same menu, and use ⋯ to rename or remove one.

  • Each profile is its own linked device with its own folder (data/profiles/ /): login, messages and media are never shared. The first profile ("Main") keeps the original data folder, so existing installs need no migration.
  • One AI connection reaches all of them. Every tool takes an optional profile (a name or id), and list_profiles shows what's linked. Without profile, tools use Main. For example: *"Check my Work WhatsApp for anything urgent."*
  • Removing a profile unlinks Relay from that WhatsApp account and deletes its synced data from this computer; the phone keeps everything. Main can be renamed but not removed.
Dashboard sign-in

The first time you open the dashboard, you create the bridge's owner account:

  1. Enter your full name, country, phone number (with its country code) and email.
  2. Choose a strong password: 12+ characters with upper and lower case, a number and a symbol. It can't contain your name or email, and the form shows each rule as you type.
  3. Relay emails a 6-digit code to confirm your email. Enter it, and you're in.

After that you sign in with your email and password, or with Google, Microsoft, GitHub or Facebook if they're set up. Forgot password? emails a code to reset it.

  • Who can create an account: a local bridge only a

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