---
title: WHOOP MCP connector
description: 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 Connector

A local-first MCP connector that lets agents reason over WHOOP recovery, sleep, cycles and workouts without handing OAuth tokens to the model.

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

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

## 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/