---
title: WHOOP MCP server for AI agents
description: WHOOP MCP server for recovery score, HRV, sleep stages and day strain.
canonical: https://wellness.delx.ai/connectors/whoop
content_signal: ai-train=no, search=yes, ai-input=yes
---

# WHOOP MCP server for AI agents

The WHOOP MCP server uses the official WHOOP OAuth API v2 so agents can work with recovery, sleep, strain and workout context without handing OAuth tokens to the model.

## Short answer

The WHOOP MCP connector for AI agents is a local-first server provided by whoop-mcp-unofficial. It uses the official WHOOP OAuth API v2 and user-authorized scopes to expose scored recovery, HRV, resting heart rate, sleep, cycles, strain and workout context to an MCP-compatible client. OAuth tokens stay on the user's machine or server; the connector does not provide live BLE or continuous sensor telemetry, and Delx does not host a copy of the data.

## Install

```bash
npx -y whoop-mcp-unofficial setup
npx -y whoop-mcp-unofficial doctor
```

## Agent client config

```json
{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "whoop-mcp-unofficial"]
    }
  }
}
```

## Signals

- Recovery
- HRV
- Sleep
- Strain
- Workouts

## Data availability

- Recovery score, HRV, RHR, SpO2, skin temperature: available. Available when WHOOP returns a scored recovery.
- Sleep sessions, stages and performance: available. All scored sleep records.
- Cycles, day strain and kilojoules: available. Physiological cycle records.
- Workouts, sport and heart-rate zones: available. All recorded workouts exposed by the public API.
- Profile and body measurements: available. Height, weight and max heart rate.
- Continuous heart-rate or live BLE telemetry: not_available. Not exposed by the public WHOOP API; this connector is not a Bluetooth listener.

## MCP tools

### Profile and onboarding

- `whoop_profile_get`
- `whoop_profile_update`
- `whoop_onboarding`

### Start here

- `whoop_connection_status`
- `whoop_daily_summary`
- `whoop_weekly_summary`

### Auth and diagnostics

- `whoop_capabilities`
- `whoop_agent_manifest`
- `whoop_privacy_audit`
- `whoop_cache_status`
- `whoop_get_auth_url`
- `whoop_exchange_code`
- `whoop_revoke_access`

### Profile

- `whoop_get_profile`
- `whoop_get_body_measurements`

### Collections

- `whoop_list_recoveries`
- `whoop_list_sleeps`
- `whoop_list_cycles`
- `whoop_list_workouts`

### Single records

- `whoop_get_cycle`
- `whoop_get_sleep`
- `whoop_get_workout`
- `whoop_get_cycle_sleep`
- `whoop_get_cycle_recovery`

## Prompts

- `whoop_daily_performance_coach`
- `whoop_weekly_training_review`
- `whoop_sleep_recovery_investigator`

## Resources

- `whoop://capabilities`
- `whoop://summary/daily`
- `whoop://summary/weekly`
- `whoop://latest/recovery`
- `whoop://latest/sleep`
- `whoop://latest/cycle`

## Privacy

- Read-only by default.
- OAuth secrets and refresh tokens stay on the user's machine or server.
- Collection tools support summary, structured and raw response formats.
- The connector distinguishes upstream raw JSON from raw sensor telemetry.
- Profile and goals persist locally to ~/.delx-wellness/profile.json (mode 0600); shared with all 14 Delx Wellness connectors and never uploaded.

## Best for

- Daily readiness check-in
- Sleep and recovery investigation
- Weekly strain planning
- Workout load review

## Known limits

- No live sensor stream.
- No raw accelerometer or Bluetooth data.
- Requires a WHOOP account and developer app.

## Links

- GitHub: https://github.com/davidmosiah/whoop-mcp
- npm: https://www.npmjs.com/package/whoop-mcp-unofficial
- Legacy docs: https://whoopmcp.vercel.app/
- Provider docs: https://developer.whoop.com/api/