Whoop MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Utilizes environment variables for storing Whoop credentials, with support for .env configuration files.

  • Supports deployment on macOS through Claude for Desktop configuration, with specific paths for the macOS environment.

  • Built as a Python package (3.12) that implements the MCP server functionality to connect with the Whoop API.

Whoop MCP サーバー

Python パッケージ ライセンス: MIT Python 3.12

Whoop APIへのアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー。言語モデルがWhoop APIからサイクル、回復、負荷、ワークアウトデータを照会できるようにします。

利用可能なツール

サーバーは次のツールを公開します。

サイクルクエリ

  • get_cycle_collection(start_date: str, end_date: str) : 特定の日付範囲の周期データを取得する
  • get_latest_cycle() : 最新のサイクルデータを取得する

回復と負担

  • get_recovery_data(start_date: str, end_date: str) : 特定の日付範囲の回復データを取得する
  • get_strain_data(start_date: str, end_date: str) : 特定の日付範囲の株データを取得する
  • get_average_strain(days: int = 7) : 指定した日数の平均ひずみを計算する

プロフィールと認証

  • get_profile() : ユーザーのプロフィール情報を取得する
  • check_auth_status() : Whoop APIで認証ステータスを確認する

日付は ISO 形式 (YYYY-MM-DD) で指定する必要があります。

使用法

このサーバーを使用するにはWhoopの認証情報が必要です。サーバーはWhoop APIを使用してメールアドレスとパスワードによる認証を行います。

デスクトップ版クロード

claude_desktop_config.json (macOS では~/Library/Application\ Support/Claude/claude_desktop_config.json 、Windows では%APPDATA%/Claude/claude_desktop_config.jsonにあります) を更新して、以下を追加します。

{ "mcpServers": { "Whoop": { "command": "python", "args": ["/path/to/whoop/src/whoop_server.py"], "cwd": "/path/to/whoop", "env": { "WHOOP_EMAIL": "your.email@example.com", "WHOOP_PASSWORD": "your_password" } } } }

HTTP API サーバー

このプロジェクトには、HTTPエンドポイント経由で同じ機能を公開するHTTP APIサーバーも含まれています。実行するには、以下の手順に従ってください。

./run_whoop_server.sh

クエリの例

接続すると、次のような質問をクロードに尋ねることができます。

  • 「今日の回復スコアは?」
  • 「過去1週間の私の株データを見せてください」
  • 「過去 7 日間の平均負担はどれくらいですか?」
  • 「最新の周期データを取得」

エラー処理

サーバーは、一般的な問題に関して人間が判読できるエラー メッセージを提供します。

  • 無効な日付形式
  • API認証エラー
  • ネットワーク接続の問題
  • 資格情報が見つからないか無効です

プロジェクト構造

whoop/ ├── src/ │ ├── whoop_server.py # MCP server implementation │ └── whoop_http_server.py # HTTP API server implementation ├── config/ │ └── .env # Environment variables ├── requirements.txt # Python dependencies └── run_whoop_server.sh # Script to run HTTP server

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

-
security - not tested
F
license - not found
-
quality - not tested

言語モデルに個人の Whoop フィットネス データへのアクセスを提供し、Whoop API からサイクル、回復、負担、トレーニング情報をクエリできるようにするモデル コンテキスト プロトコル サーバー。

  1. Available Tools
    1. Cycle Queries
    2. Recovery and Strain
    3. Profile and Authentication
  2. Usage
    1. Claude for Desktop
    2. HTTP API Server
  3. Example Queries
    1. Error Handling
      1. Project Structure
        1. License
          ID: mlb49q0786