すべてのWHOOP APIエンドポイントへのアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー。 このサーバーでは、WHOOPフィットネスと健康データをMCP標準でアプリケーションに統合することができます。

##特徴

• 完全なWHOOP APIの適用範囲:すべてのWHOOP v2 APIのエンドポイントへのアクセス
• OAuth 2.0 認証: 安全な認証フロー
• ユーザーデータ:プロフィール情報およびボディ測定
• サイクル:緊張と心拍数メトリックの生理学的サイクルデータ
• 回復:回復スコア、HRV、および心拍数データを復元する -Sleep:ステージとパフォーマンスメトリックを含む詳細な睡眠分析
• ワークアウト: 緊張、心拍数の地帯および活動のメートルが付いている練習データ -Pagination Support:パジネーションで大きなデータセットを処理する
• TypeScript:フルタイプの安全およびIntelliSenseサポート

前提条件

• Node.js 18 +
• WHOOP開発者アカウント
• WHOOP APIの資格情報

セットアップ

##1. 依存関係のインストール

##2.WHOOP API セットアップ

1。 WHOOP開発者プラットフォームに行く 2. 新しいアプリケーションを作成する 3. [Client ID と [Client Secret に注意してください。 4. リダイレクト URI の設定 (例、[http://localhost:3000/callback]))

##3. 環境設定

WHOOP MCP Server

A Model Context Protocol (MCP) server that provides access to all WHOOP API endpoints. This server allows you to integrate WHOOP fitness and health data into your applications through the MCP standard.

Features

• Complete WHOOP API Coverage: Access to all WHOOP v2 API endpoints
• OAuth 2.0 Authentication: Secure authentication flow
• User Data: Profile information and body measurements
• Cycles: Physiological cycle data with strain and heart rate metrics
• Recovery: Recovery scores, HRV, and resting heart rate data
• Sleep: Detailed sleep analysis including stages and performance metrics
• Workouts: Exercise data with strain, heart rate zones, and activity metrics
• Pagination Support: Handle large datasets with pagination
• TypeScript: Full type safety and IntelliSense support

Prerequisites

• Node.js 18+
• WHOOP Developer Account
• WHOOP API credentials

Setup

1. Install Dependencies

npm install

2. WHOOP API Setup

1. Go to the WHOOP Developer Platform
2. Create a new application
3. Note your Client ID and Client Secret
4. Set your redirect URI (e.g., http://localhost:3000/callback)

3. Environment Configuration

Copy the example environment file and configure your WHOOP credentials:

cp env.example .env

Edit .env with your WHOOP API credentials:

# WHOOP API Configuration
WHOOP_CLIENT_ID=your_client_id_here
WHOOP_CLIENT_SECRET=your_client_secret_here
WHOOP_REDIRECT_URI=http://localhost:3000/callback

# MCP Server Configuration
MCP_SERVER_PORT=3001

4. Build and Run

# Build the project
npm run build

# Run the MCP server
npm start

# Or run in development mode
npm run dev

Authentication Flow

The MCP server supports OAuth 2.0 authentication with WHOOP. Here’s how to authenticate:

1. Get Authorization URL: Use the whoop-get-authorization-url tool to get the OAuth URL
2. User Authorization: Direct users to the authorization URL
3. Copy Authorization Code: When WHOOP redirects you back, copy the authorization code from the URL
4. Share Code with Claude: IMPORTANT - You must copy and paste the authorization code directly to Claude in the chat
5. Exchange Code: Claude will use the whoop-exchange-code-for-token tool with the authorization code
6. Set Access Token: Claude will use the whoop-set-access-token tool to set the access token for API calls

⚠️ Important Note About Authorization Codes

When you complete the WHOOP authorization in your browser, you’ll be redirected to a URL that contains an authorization code. You must copy this code and paste it directly into your chat with Claude. The code will look something like this in the URL:

http://localhost:3000/callback?code=ABC123XYZ789&scope=read:recovery%20read:cycles...