whoop-mcp

Overview

whoop-ai-mcp is a well-structured MCP server that provides AI assistants with access to WHOOP's health and fitness data. The server implements OAuth2 authentication with secure token storage and automatic refresh, ensuring secure access to sensitive health information. It exposes six tools: recovery data, sleep metrics, workout records, physiological cycles, body measurements, and profile information. The implementation uses TypeScript with minimal dependencies, making it lightweight and efficient.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_profile()

  Get the authenticated user's basic profile — name and email.

  Try:Show me my profile informationTry:What's my name and email in WHOOP?
• get_body_measurement()

  Get the user's body measurements — height, weight, and max heart rate.

  Try:Show my latest body measurementsTry:What's my current weight and max heart rate?
• get_recovery_collection(start?, end?, limit?, nextToken?)

  Get recovery scores for a date range. Returns HRV, resting heart rate, SpO2, and skin temp.

  Try:How was my recovery this week?Try:Show my recovery scores for the last 5 days
• get_sleep_collection(start?, end?, limit?, nextToken?)

  Get sleep records for a date range. Returns sleep stages, duration, respiratory rate.

  Try:Show me my sleep data from last weekTry:How much sleep did I get last night?
• get_workout_collection(start?, end?, limit?, nextToken?)

  Get workout records for a date range. Returns strain, heart rate zones, calories, sport type.

  Try:What workouts did I do this month?Try:Show me my recent running workouts
• get_cycle_collection(start?, end?, limit?, nextToken?)

  Get physiological cycles for a date range. Returns strain, calories, heart rate data per cycle.

  Try:Show me my physiological cycles from last monthTry:What was my strain during my last cycle?

Comparable tools

Installation

Server name: io.github.shashankswe2020-ux/whoop

{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["whoop-ai-mcp"],
      "env": {
        "WHOOP_CLIENT_ID": "your_client_id",
        "WHOOP_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

npm install -g whoop-ai-mcp

FAQ

How do I authenticate with WHOOP?

The server uses OAuth2 with PKCE. On first run, a browser window will open for you to authorize access to your WHOOP data.

Where are tokens stored?

Tokens are cached at ~/.whoop-mcp/tokens.json with 0600 permissions (user-only read/write).

Compare whoop-mcp with