whoop

Name: whoop
Author: shashankswe2020-ux

ローカル

github.com/shashankswe2020-uxヘルスケア1753 日前に更新

リポジトリ

whoop について

whoopは、互換性のあるアシスタントからWHOOPの健康・トレーニング記録を参照できる読み取り専用のMCPサーバーです。個人ベースライン、傾向、サマリー、レース分析を提供し、ローカルツールではレース記録やワークアウト修正、ダッシュボードも扱えます。

主な機能

01回復・睡眠・ワークアウトデータの取得
02傾向と個人ベースラインの比較
03健康レビューのサマリー作成
04HYROXとトライアスロンの分析
05ローカルのレースデータの監査と修正
06ローカルパフォーマンスダッシュボードの起動

活用シーン

01週ごとの回復と睡眠の確認
02HRVと個人ベースラインの比較
03HYROXやトライアスロンのトレーニング管理
04記録済みレースデータの確認と修正

MCP 対応

MCPクライアントに、読み取り専用のWHOOPデータツール、リソース、プロンプトテンプレートを提供します。ローカルstdioではレース記録、ワークアウト修正、ダッシュボードも利用できます。リモート接続にはサーバーのデプロイと互換コネクターが必要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "shashankswe2020-ux-whoop": {
      "command": "npx",
      "args": [
        "-y",
        "whoop-ai-mcp"
      ],
      "env": {
        "WHOOP_CLIENT_ID": "<WHOOP_CLIENT_ID>",
        "WHOOP_CLIENT_SECRET": "<WHOOP_CLIENT_SECRET>"
      }
    }
  }
}

起動コマンドnpx -y whoop-ai-mcp

設定が必要な環境変数

WHOOP_CLIENT_IDシークレットYour WHOOP Developer App Client ID from developer.whoop.com

WHOOP_CLIENT_SECRETシークレットYour WHOOP Developer App Client Secret from developer.whoop.com

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmwhoop-ai-mcp0.5.2stdio

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

whoop-ai-mcp は、macOS 上の Claude、Gemini CLI、Cursor、VS Code、OpenClaw、Perplexity や、その他の MCP クライアント向けの、読み取り専用の WHOOP MCP サーバーです。データを自分でエクスポートすることなく、回復状況について尋ねたり、週ごとの睡眠を比較したり、今日の状態を自分の基準値と照らし合わせたりできます。ChatGPT、Claude web/mobile、Grok xAI API を利用するにはリモートサーバーへのデプロイが必要です。クライアント設定ガイドをご覧ください。

npx -y whoop-ai-mcp@latest setup --client=claude-desktop

クイックスタート | 使い方の解説を見る | ウェブサイト | ツールのリファレンス

Claude Desktop の WHOOP MCP：回復、HRV、睡眠、ワークアウトの概要をまとめた週間ヘルスレビュー
_{Claude Desktop がレビューを作成し、whoop-ai-mcp がデータを提供します。結果やレイアウトは異なる場合があります。}

WHOOP のデータについて何でも尋ねる

質問	得られる情報
「今日はどんな調子？」	回復状況、主睡眠、ストレイン、最新のワークアウト。データがない項目は明示されます
「自分の HRV は普段と比べて異常？」	個人の基準値：分布、パーセンタイル、および算出に使われた日数
「今月、睡眠はどう変化した？」	傾向、期間ごとの比較、睡眠負債、一貫性
「週次のヘルスレビューを作って」	回復、睡眠、トレーニングをまとめた概要

統計は記録された履歴を示すものです。医療上の診断や予測ではありません。

クイックスタート

必要なもの： Node.js 20 以降、有効な WHOOP メンバーシップ、リダイレクト URL に http://localhost:3000/callback を設定した WHOOP Developer App。

セットアップします。 使用するアシスタントのコマンドを実行し、求められたら Developer App のクライアント ID とシークレットを入力します。

アシスタント	コマンド
Claude Desktop	`npx -y whoop-ai-mcp@latest setup --client=claude-desktop`
Claude Code	`npx -y whoop-ai-mcp@latest setup --client=claude-code`
Codex	`npx -y whoop-ai-mcp@latest setup --client=codex`
GitHub Copilot	`npx -y whoop-ai-mcp@latest setup --client=copilot`
Gemini CLI	`npx -y whoop-ai-mcp@latest setup --client=gemini-cli`
Cursor	`npx -y whoop-ai-mcp@latest setup --client=cursor`
VS Code	`npx -y whoop-ai-mcp@latest setup --client=vscode`
OpenClaw	`npx -y whoop-ai-mcp@latest setup --client=openclaw`
Perplexity（macOS アプリ＋ヘルパー）	`npx -y whoop-ai-mcp@latest setup --client=perplexity`

Claude Code、Codex、VS Code/Copilot の場合は、セットアップで表示される登録コマンドを実行します。Gemini CLI、Cursor、OpenClaw の場合は、表示される設定を統合します。Perplexity の場合は、表示される起動コマンドをローカルコネクタに貼り付けます。グローバルには何もインストールされず、任意の使用状況テレメトリはデフォルトで No です。

Desktop 用の claude エイリアスを含むこれらのターゲットには、1.1.0 以降が必要です。ソースからビルドする場合は、node dist/index.js setup --client=<target> を使用してください。

認証します。 アシスタントを完全に終了してから、再度開きます。サーバーが初めて起動すると、WHOOP がブラウザーで開き、アクセスを承認できます。
質問します。 *「今週の睡眠と回復について要約してください。」*と聞いてみましょう。

手動設定、環境変数、またはリモートデプロイについては、セットアップガイド全文をご覧ください。

Claude ウェブ／モバイル版と ChatGPT のクイックセットアップ

どちらの実装でも setup --client=claude-web または setup --client=chatgpt を実行すると、リモートデプロイとコネクタの手順が表示されます。これらのターゲットはガイダンスのみで、ワンクリックでホスティングできるものではありません。公開 HTTPS /mcp エンドポイントを用意し、ホスト上で WHOOP の認証を完了してから、互換性のあるコネクタ OAuth を設定してください。利用可否はクライアントのアカウント／ワークスペースによって異なります。setup --client=grok を実行すると、xAI API 用の MCP ツールの例が表示されます。一般ユーザー向けの Grok チャット連携は検証されていません。リモート認証情報は収集されず、クライアント接続のテストも行われません。

ネイティブバイナリをお使いですか？

Rust 実装では、サーバーに Node.js ランタイムを使わずに同じクライアントターゲットと制限事項を利用できます。Rust 1.88 以降が必要です。

cargo install whoop-mcp
whoop-mcp setup --client=claude-desktop

追加の Rust ターゲットには、0.2.0 以降が必要です。ソースからビルドする場合は、Rust のチェックアウト内で cargo run -- setup --client=<target> を使用してください。

## 仕組み

WHOOP アカウントから whoop-ai-mcp に読み取り専用アクセスを許可します。whoop-ai-mcp は、16 個の読み取り専用ツールを備え、ホスト型リレーを介さずにコンピューター上で動作します。ツールの結果は、Claude Desktop、Claude Code、Codex、GitHub Copilot などの AI アシスタントに送信されます。

読み取り専用です。 サーバーには、WHOOP アカウント内の情報を作成、変更、削除するツールはありません。レース結果とワークアウトの修正内容は、監査ログとともにローカルファイルにのみ保存されます。
デフォルトではローカルで動作します。 サーバーはお使いのマシン上で動作します。ホスト型リレーは使用しません。
結果はアシスタントに表示されます。 健康データは、チャットで共有するほかの情報と同様に、お使いのアシスタントプロバイダーに届きます。
集計モードでは、サーバーの機能を5つの要約ツールに限定し、レコードごとのデータを非表示にします。共有される情報は減りますが、匿名化されるわけではありません。
テレメトリーは、オプトインしない限りオフです。 健康データやチャットのテキストが含まれることはありません。

詳細：データの取り扱いとテレメトリーの制御。

含まれる機能

標準モードでは、サーバーは読み取り専用ツール16個、リソース4個、プロンプトテンプレート5個に加え、HYROXおよびトライアスロン用ツール9個を提供します。リソース、プロンプト、リモート接続のサポート状況は、お使いのアシスタントによって異なります。

HYROX とトライアスロンのトラッキング

「昨日のHYROXシミュレーションはどうだった？」や「2週間後のトライアスロンに向けて準備はできている？」と尋ねられます。レース用ツールでは、次のことができます。

WHOOP の連続するワークアウトから HYROX セッションを再構成します。区間のタイムライン、トランジション時間、ゾーン滞在時間、ルールベースの分析情報を表示します。
週ごとのランニングと HYROX の負荷、スイム／バイク／ランのバランスとブリックトレーニング、ステーション別・レグ別のスプリットや PR を含む記録済みレースを追跡します。
リカバリー、トレーニングフォーム、競技特異性、睡眠負債、テーパーに基づくレディネスの段階を提示します。各要素には根拠が示され、不透明なスコアはありません。
数値を監査できます。疑わしいワークアウトにはフラグが付き、ワークアウトのラベル変更や除外が可能です。変更はすべて記録され、verify_claim でアシスタントが提示した数値を再計算できます。
127.0.0.1 上でグラフを中心としたローカルダッシュボード（open_performance_dashboard）を開き、「今日」「セッション」「トレーニング」「HYROX」「トライアスロン」「レディネス」「監査」のビューを利用できます。ダーク／ライトテーマ、ローカルフォント、保存前の確認機能も備えています。

グラフを中心としたセッションビュー：記録されたランニングとエルゴの9つの区間、平均および最大心拍数の推移、ランごとの負荷増加、記録区間リングを表示します。サンプルデータは合成データです。

レディネスビュー：5要素の根拠リング、「準備未完了」の判定、各要素の段階、理由、根拠の開示を表示します。サンプルデータは合成データです。

監査ビュー：フラグ付きワークアウトのタイル、ルールベースの指摘、修正用コントロールを表示します。フラグによってワークアウトが自動的に除外されることはありません。サンプルデータは合成データです。

_{スクリーンショットには合成サンプルデータを使用しています。}

### 1.0.2 の新機能：チャートを中心としたダッシュボード

アシスタントに 「自分のパフォーマンスダッシュボードを開いて」 と頼むと、ローカルで起動できます。最新の main ブランチのデザイン刷新が、プロトタイプだけでなく実際に使えるダッシュボードに反映されました。デフォルトはダークモードで、未保存のフォームを保持するライト／ダーク切り替え機能があります。デフォルトで表示されるのはセッションです。

今日： 回復リングと、回復、HRV、安静時心拍数、睡眠ステージの過去5週間分を、共通のクロスヘア付きの単一タイムラインに表示します。データがない日は空白のままです。履歴バンドは医学的な基準値ではなく、表示中のデータを示します。
トレーニング： UTC の週ごとの WHOOP ゾーン分数を、データのない週も含めて表示します。ワークアウトの負荷／時間バブルと、フィットネス／疲労／フォームのチャートも表示します。ローカルでの修正が反映されます。
セッションとレディネス： 記録済みセグメントのリングと5つの構成要素のリング、概要の心拍数チャート、根拠を表示します。連続した心拍数の推移や、HYROX のステーション別スプリットを捏造することはありません。
保存前に確認。 ワークアウトの修正やレース結果を確認し、編集、キャンセル、確定ができます。保存に失敗しても入力内容は保持されます。
コンテキストを維持。 表示を切り替えてもフィルターは保持されます。「過去7日間」と「過去28日間」のプリセットでは、完了済みの UTC 日を使用します。
正確に更新。 更新と再試行のコントロールは、WHOOP の同期時刻ではなく、ビューの読み込み時刻を報告します。読み取りにはキャッシュ済みデータが使われる場合があります。

ダークテーマのチャート中心の「今日」ダッシュボード：回復リングと、回復、HRV、安静時心拍数、睡眠ステージの共通タイムラインチャート。空白の日と履歴バンドを表示。合成サンプルデータ。
_{合成サンプルデータを使った「今日」ビュー。WHOOP の回復度はレースへの準備状況を判定するものではありません。ローカルでのワークアウト修正はレースビューに反映されますが、この概要には反映されません。}

週ごとの記録済み WHOOP ゾーン分数、負荷と時間を示すワークアウトバブル、フィットネス、疲労、フォームを表示するトレーニングダッシュボード。合成サンプルデータ。

レースログ、ワークアウトの修正、ダッシュボードを利用できるのは、サーバーがローカルで実行されている場合（stdio）のみです。詳細：レースパフォーマンスツールとローカルデータ。

すべてのツールとプロンプトを表示

グループ	ツール
今日とベースライン	`get_today`, `get_baselines`, `get_sleep_debt`
トレンドとレビュー	`get_weekly_summary`, `get_trend`, `compare_periods`, `get_calendar`
記録	`get_recovery_collection`, `get_sleep_collection`, `get_workout_collection`, `get_cycle_collection`, `get_sleep_by_id`, `get_workout_by_id`, `get_cycle_by_id`
プロフィール	`get_profile`, `get_body_measurement`
HYROX とトライアスロン	`get_hyrox_session_report`, `get_hyrox_performance`, `get_triathlon_performance`, `get_race_readiness`, `audit_performance_data`, `verify_claim`
ローカルのみ：レースログ、修正、ダッシュボード	`log_race_result`, `annotate_workout`, `open_performance_dashboard`

プロンプトテンプレート： weekly_health_review, sleep_analysis, recovery_trend, workout_recap, health_check

パラメーター、日付表現、リソース、キャッシュについてはツールリファレンスをご覧ください。

## ドキュメント

ガイド	内容
インストール	アシスタント、手動設定、環境変数、WHOOP の認可
ツールリファレンス	すべてのツールとそのパラメーター、日付表現、リソース、プロンプト、キャッシュ
プライバシー	構造化された結果、集計モード、アシスタントプロバイダーが受け取る情報
テレメトリー	同意、オプトアウト、収集内容、保存期間
トラブルシューティング	ローカル診断、よくあるエラー、MCP Inspector
デプロイ	Docker、クラウドホスティング、リモートコネクターの OAuth
開発	テスト、プロジェクト構成、リリースワークフロー
背景情報	エコシステムの調査、動画による解説

最近の変更については、変更履歴または最新リリースをご覧ください。

フィードバックとコントリビューション

動作しない箇所や、質問したいことがある場合は、上のボタンをご利用ください。どちらも、解決に必要な情報を尋ねる短いフォームが開きます。Issue は公開されるため、認証情報や健康記録は絶対に記載しないでください。セキュリティ上の問題は、代わりにセキュリティポリシーに従って報告してください。

コードで貢献したい場合は、コントリビューションガイドをお読みください。参加するすべての方に、行動規範の遵守をお願いしています。

whoop-ai-mcp が役に立った場合、GitHub でスターを付けていただくと、ほかの方にも見つけてもらいやすくなります。また、開発を支援するためにコーヒーをおごることもできます。

プロジェクトの成長

_{ダウンロード数には自動インストールが含まれるため、実際のユーザー数とは異なる場合があります。}

ライセンス

MIT。これは非公式プロジェクトであり、WHOOP とは提携していません。WHOOP のメンバーシップと API アクセスは、このパッケージとは別に必要です。

Markdown 対応

ログインしてコメント

基本情報

作者: shashankswe2020-ux
言語: node
バージョン: 0.5.2
トランスポート: stdio
掲載日: 2026年6月3日
最終更新: 3 日前
公式 Registry: io.github.shashankswe2020-ux/whoop

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

whoop

whoop について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

WHOOP のデータについて何でも尋ねる

クイックスタート

Claude ウェブ／モバイル版と ChatGPT のクイックセットアップ

含まれる機能

HYROX とトライアスロンのトラッキング

フィードバックとコントリビューション

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？