WHOOP (read-only)

WHOOP MCP サーバー（読み取り専用）

Claude、Cursor、VS Code、または任意のMCPクライアントから、WHOOPのリカバリー、HRV、睡眠、ストレイン、ワークアウトについて質問できます。データを変更する手段を与えることはありません。

_{npm run demoで記録した、実際のWHOOPデータに基づく回答です。}

「昨夜の睡眠はどうでしたか？今日はなぜリカバリーが41％しかないのですか？」 「過去30日間のHRVと安静時心拍数を比較してください。」 「今月は何回ランニングをしましたか？平均ストレインはいくつでしたか？」 「ストレインが15を超えた日の後は、リカバリーが悪くなりますか？」

（インストールの前または後に、1回限りのauth手順を実行してください。）

このサーバーを選ぶ理由

• 読み取り専用を徹底しています。 WHOOP のread:*スコープのみをリクエストします。HTTP クライアントが送信できるのはGETのみであり、それ以外の場合はテストでビルドが失敗します。また、すべてのツールにreadOnlyHint: trueが設定されています。
• 質問全体に1回の呼び出しで回答します。 get_daily_overviewは、1日のリカバリー、睡眠、昼寝、ストレイン、ワークアウトをまとめて返します。get_trendsは、最大90日間の平均、範囲、リカバリーゾーンを返します。
• モデルが扱いやすい出力です。 ミリ秒やキロジュールではなく、時間、km、kcal、現地時刻を含むコンパクトなJSONを返すため、トークンを節約し、単位変換のミスを防げます。WHOOP の元のオブジェクトが必要な場合は、raw: trueを指定してください。
• トークンはお使いのマシン上に保管されます。 ご自身のWHOOP開発者アプリ、0600のトークンファイル、WHOOPのローテーションするリフレッシュトークンの安全な取り扱いを使用します。サードパーティのサーバーは使用しません。
• 最新のAPIに対応しています。 WHOOP Developer API v2を基盤に構築されています。
• テスト済みです。 Linux、macOS、Windowsで、Node 20、22、24を使ってユニットテスト、MCP統合テスト、エンドツーエンドテスト、パッケージングテストを実行します。

クイックスタート

Node.js 20.11以降とWHOOPのメンバーシップが必要です。

1. WHOOP開発者アプリを作成する（2分）

1. WHOOP Developer Dashboardを開き、チームの作成を求められた場合は作成します。
2. アプリを作成します。
   • スコープ： すべてのread:*スコープ（リカバリー、サイクル、ワークアウト、睡眠、プロフィール、身体測定）を選択します。
   • リダイレクトURI： http://localhost:8787/callback
3. Client IDとClient Secretをコピーします。

2. WHOOP アカウントを接続する

npx -y @oryanomer/whoop-mcp auth

求められたら、Client ID と Client Secret を貼り付けます。シークレットは画面に表示されないため、画面やシェルの履歴に残りません。続いて、ブラウザーで WHOOP の同意ページが開きます。承認すると、トークンが ~/.config/whoop-mcp/tokens.json に保存され、以降は自動的に更新されます。

（スクリプトで使用する場合は、プロンプトに回答する代わりに、環境変数として WHOOP_CLIENT_ID と WHOOP_CLIENT_SECRET を設定できます。）

接続することで、利用規約（EULA）および WHOOP のAPI 利用規約に同意したものとみなされます。データの取り扱いについては、プライバシーポリシーをご覧ください。

3. MCP クライアントに追加する

/plugin marketplace add oryanomer1/whoop-mcp
/plugin install whoop@whoop-mcp

claude mcp add whoop --scope user -- npx -y @oryanomer/whoop-mcp

{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "@oryanomer/whoop-mcp"]
    }
  }
}

{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "@oryanomer/whoop-mcp"]
    }
  }
}

{
  "servers": {
    "whoop": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@oryanomer/whoop-mcp"]
    }
  }
}

{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "@oryanomer/whoop-mcp"]
    }
  }
}

[mcp_servers.whoop]
command = "npx"
args = ["-y", "@oryanomer/whoop-mcp"]

docker build -t whoop-mcp https://github.com/oryanomer1/whoop-mcp.git
docker run -i --rm -v ~/.config/whoop-mcp:/home/node/.config/whoop-mcp whoop-mcp

次のように尋ねてみましょう：「今日の WHOOP の概要を教えてください。」

ツール

一覧ツールでは、start / end（YYYY-MM-DD または ISO 日時）、days ショートカット、limit（最大 200 件、自動ページネーションあり）、next_token を指定できます。すべてのパラメーターと出力例については、**ツールリファレンス**をご覧ください。

設定

whoop-mcp            Start the MCP server on stdio (what your MCP client runs)
whoop-mcp auth       Connect your WHOOP account (opens your browser)
whoop-mcp status     Check the stored connection
whoop-mcp logout     Delete the locally stored tokens
whoop-mcp --version

すべてのコマンドは npx -y @oryanomer/whoop-mcp <command> で実行するか、npm install -g @oryanomer/whoop-mcp でグローバルにインストールして実行します。

プライバシーとセキュリティ

プライバシーポリシー の全文をお読みください。概要は次のとおりです。

• whoop-mcp は api.prod.whoop.com とのみ通信します。テレメトリーや仲介サーバーはありません。
• トークンとクライアントシークレットは、ユーザー本人のみが読み取れる（0600）1 つのファイルに保存されます。ログに記録されたり、ツールから返されたりすることはありません。
• MCP クライアントはツールの結果を言語モデルに送信します。 問い合わせた健康データは、そのモデルプロバイダーの規約に基づいて共有されます。そのため、信頼できるクライアントとプロバイダーを使用してください。
• 接続を解除するには、whoop-mcp logout を実行してローカルトークンを削除します。アクセスを完全に取り消すには、アプリを削除するか、WHOOP Developer Dashboard でシークレットをローテーションしてください。

脅威モデルの全文は SECURITY.md にあります。脆弱性は GitHub のセキュリティアドバイザリー から非公開で報告してください。

認証の仕組み

• WHOOP のアクセストークンの有効期間は 1 時間です。whoop-mcp は有効期限の約 1 分前にトークンを更新し、WHOOP が 401 を返した場合にも再度更新します。
• WHOOP は更新のたびに新しいリフレッシュトークンを発行し、同時に実行された更新を拒否します。whoop-mcp はリクエストを 1 つずつ更新し、ロックファイルを使用することで、同じマシン上の複数のクライアント（例：Claude Desktop と Claude Code）が同時に更新しないようにします。また、新しいトークンはアトミックに書き込みます。書き込みに失敗した場合も、新しいトークンはメモリ内に保持されるため、ディスク容量がいっぱいになってもログアウトされることはありません。
• レート制限（429）、WHOOP サーバーエラー、タイムアウト（リクエストごとに 30 秒）、ネットワークエラーは、Retry-After に従ってバックオフしながら再試行されます。クライアントでリクエストをキャンセルすると、WHOOP への呼び出しも停止します。

トラブルシューティング

接続状態はいつでも確認できます。

npx -y @oryanomer/whoop-mcp status

アンインストール

npx -y @oryanomer/whoop-mcp logout

その後、MCP クライアントの設定から whoop エントリを削除し、不要になった場合はWHOOP Developer Dashboardでアプリを削除してください。

コントリビューション

Issueやプルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。唯一の厳守事項は、whoop-mcpを読み取り専用に保つことです。リリースノートはCHANGELOG.mdにあります。

法的事項

• ライセンス： MIT © Oryan Omer
• 利用規約（EULA）： EULA.md。whoop-mcpをインストールまたは使用することで、これらの規約に同意したものとみなされます。
• プライバシーポリシー： PRIVACY.md
• セキュリティポリシー： SECURITY.md

これは非公式のプロジェクトであり、WHOOP, Inc.とは提携しておらず、同社から承認を受けていません。「WHOOP」はWHOOP, Inc.の商標です。ここに記載されている内容は、医療上の助言ではありません。