WHOOP MCP Server

MCP server for WHOOP biometric data. Query recovery, strain, sleep, workouts, and heart rate from any MCP-compatible AI client.

Two Modes

• Remote — Calls /api/whoop/stats on a deployed WHOOP-connected site (e.g., patrickwingert.com)

• Direct — Talks to the WHOOP API directly with local OAuth + token storage

Both modes expose the same 11 tools through a shared interface.

Related MCP server: Whoop MCP Server

Setup

1. Build

npm install
npm run build

2. Configure Claude Code

Remote mode (uses an existing WHOOP-connected site):

{
  "mcpServers": {
    "whoop": {
      "command": "node",
      "args": ["/path/to/whoop-mcp-server/dist/index.js"],
      "env": {
        "WHOOP_MODE": "remote",
        "WHOOP_BASE_URL": "https://patrickwingert.com"
      }
    }
  }
}

Direct mode (standalone, talks to WHOOP API):

{
  "mcpServers": {
    "whoop": {
      "command": "node",
      "args": ["/path/to/whoop-mcp-server/dist/index.js"],
      "env": {
        "WHOOP_MODE": "direct",
        "WHOOP_CLIENT_ID": "your-client-id",
        "WHOOP_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

3. Direct Mode — WHOOP Developer Setup

1. Go to WHOOP Developer Portal

2. Create a new application

3. Set redirect URI to http://localhost:8787/callback

4. Enable scopes: read:profile, read:recovery, read:cycles, read:workout, read:sleep, read:body_measurement

5. Copy Client ID and Client Secret to your config

4. Direct Mode — OAuth Flow

On first use, the server will need OAuth tokens. The OAuth flow:

1. Server starts a temporary listener on localhost:8787

2. Open the generated authorization URL in your browser

3. Authorize on WHOOP's site

4. Tokens are stored in ~/.whoop-mcp/tokens.json (chmod 600)

5. Tokens auto-refresh going forward

Tools

Tier 1 — Biometric Data (read-only)

Tier 2 — Diagnostics

All tools support response_format: markdown (default, human-readable) or json (structured data).

Environment Variables

Local Storage (Direct Mode)

~/.whoop-mcp/
├── tokens.json      # OAuth tokens (chmod 600)
└── cache.json       # Cached API responses

Testing

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js