Skip to main content
Glama

WHOOP MCP Server

by nissand
GitHub
TypeScript
MIT License
1
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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...

Copy the code parameter value (e.g., ABC123XYZ789) and paste it in your chat with Claude. Claude will then use this code to exchange it for an access token and set up the connection to your WHOOP data.

Available Tools

User Tools

  • whoop-get-user-profile - Get basic user profile information

  • whoop-get-user-body-measurements - Get body measurements (height, weight, max heart rate)

  • whoop-revoke-user-access - Revoke user access token

Cycle Tools

  • whoop-get-cycle-by-id - Get specific cycle data by ID

  • whoop-get-cycle-collection - Get paginated list of cycles

  • whoop-get-sleep-for-cycle - Get sleep data for a specific cycle

Recovery Tools

  • whoop-get-recovery-collection - Get paginated recovery data

  • whoop-get-recovery-for-cycle - Get recovery data for a specific cycle

Sleep Tools

  • whoop-get-sleep-by-id - Get specific sleep record by ID

  • whoop-get-sleep-collection - Get paginated sleep records

Workout Tools

  • whoop-get-workout-by-id - Get specific workout record by ID

  • whoop-get-workout-collection - Get paginated workout records

OAuth Tools

  • whoop-get-authorization-url - Get OAuth authorization URL

  • whoop-exchange-code-for-token - Exchange authorization code for access token

  • whoop-refresh-token - Refresh access token

  • whoop-set-access-token - Set access token for API calls

Usage Examples

Getting User Profile

// First set your access token await callTool('whoop-set-access-token', { accessToken: 'your_access_token' }); // Then get user profile const profile = await callTool('whoop-get-user-profile', {});

Getting Recent Cycles

const cycles = await callTool('whoop-get-cycle-collection', { limit: 10, start: '2024-01-01T00:00:00Z' });

Getting Sleep Data

const sleepData = await callTool('whoop-get-sleep-collection', { limit: 5, end: '2024-01-31T23:59:59Z' });

Getting Workout Data

const workouts = await callTool('whoop-get-workout-collection', { limit: 10, start: '2024-01-01T00:00:00Z' });

Data Types

The server provides comprehensive TypeScript types for all WHOOP API responses:

  • User Data: Profile information, body measurements

  • Cycles: Strain scores, heart rate data, kilojoule expenditure

  • Recovery: Recovery scores, HRV, resting heart rate, SpO2, skin temperature

  • Sleep: Sleep stages, performance metrics, respiratory rate, efficiency

  • Workouts: Activity strain, heart rate zones, distance, altitude data

Pagination

Most collection endpoints support pagination with the following parameters:

  • limit: Number of records to return (max 25)

  • start: Start time filter (ISO 8601)

  • end: End time filter (ISO 8601)

  • nextToken: Token for next page

Error Handling

The MCP server includes comprehensive error handling:

  • Invalid credentials

  • Rate limiting

  • Network errors

  • Invalid parameters

  • Missing required fields

Development

Project Structure

src/ ├── index.ts # Main entry point ├── mcp-server.ts # MCP server implementation ├── whoop-api.ts # WHOOP API client └── types.ts # TypeScript type definitions

Available Scripts

  • npm run build - Build the TypeScript project

  • npm start - Run the built server

  • npm run dev - Run in development mode with hot reload

  • npm run watch - Watch for changes and rebuild

Adding New Endpoints

To add new WHOOP API endpoints:

  1. Add the endpoint method to WhoopApiClient in whoop-api.ts

  2. Add corresponding types to types.ts

  3. Add the tool definition and handler to mcp-server.ts

WHOOP API Documentation

For detailed information about the WHOOP API, visit:

License

MIT License - see LICENSE file for details.

Support

For issues and questions:

  1. Check the WHOOP API documentation

  2. Review the error messages from the MCP server

  3. Ensure your OAuth credentials are correctly configured

  4. Verify your access token is valid and not expired

Migration Notice

IMPORTANT: WHOOP v2 API is now available and migration is required by October 1, 2025. The current v1 API and webhooks will be removed after this date. This MCP server uses the v2 API.

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

Enables access to WHOOP fitness and health data through all WHOOP v2 API endpoints. Supports OAuth 2.0 authentication and provides comprehensive access to user profiles, physiological cycles, recovery metrics, sleep analysis, and workout data.

  1. Features
    1. Prerequisites
      1. Setup
        1. 1. Install Dependencies
        2. 2. WHOOP API Setup
        3. 3. Environment Configuration
        4. 4. Build and Run
      2. Authentication Flow
        1. ⚠️ Important Note About Authorization Codes
      3. Available Tools
        1. User Tools
        2. Cycle Tools
        3. Recovery Tools
        4. Sleep Tools
        5. Workout Tools
        6. OAuth Tools
      4. Usage Examples
        1. Getting User Profile
        2. Getting Recent Cycles
        3. Getting Sleep Data
        4. Getting Workout Data
      5. Data Types
        1. Pagination
          1. Error Handling
            1. Development
              1. Project Structure
              2. Available Scripts
              3. Adding New Endpoints
            2. WHOOP API Documentation
              1. License
                1. Support
                  1. Migration Notice

                    Related MCP Servers

                    • Whoop MCP Server

                      ctvidic
                      -
                      security
                      -
                      license
                      -
                      quality
                      A Model Context Protocol server that provides language models with access to personal Whoop fitness data, allowing queries for cycles, recovery, strain, and workout information from the Whoop API.
                      Last updated -
                      12
                      • Apple

                    • Health & Fitness Coach MCP

                      Dinesh-Satram
                      -
                      security
                      -
                      license
                      -
                      quality
                      A comprehensive AI-powered fitness tracking application that enables AI tools to interact intelligently with user fitness data, providing personalized workout plans, nutrition tracking, and progress analysis through natural language.
                      Last updated -
                      2
                      MIT License

                    • Whoop MCP Server

                      Frenck12
                      -
                      security
                      -
                      license
                      -
                      quality
                      A secure server that allows Claude Desktop application to access and process Whoop fitness data locally, using OAuth2 authentication to protect user privacy.
                      Last updated -
                      1
                      MIT License

                    • Oura Ring MCP Server

                      JamesLouie
                      -
                      security
                      -
                      license
                      -
                      quality
                      A Model Context Protocol server that provides access to Oura Ring health and fitness data through the Oura API v2, enabling retrieval of sleep, activity, readiness, and other health metrics.
                      Last updated -

                    View all related MCP servers

                    Appeared in Searches

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/nissand/whoop-mcp-server-claude'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server