Delx Wellness
All connectors
WHOOP logo

whoop-mcp-unofficial

WHOOP

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

RecoveryHRVSleepStrainWorkouts
Install from npmRepository
Athletes stretching in a calm recovery space while reviewing wearable recovery context
OAuth 2.0

Best for recovery-led athletes, coaches and personal agents that need a daily readiness, sleep and load briefing before recommending training.

Quick Start

terminal
npx -y whoop-mcp-unofficial setup
npx -y whoop-mcp-unofficial doctor
mcp-client.json
{
  "mcpServers": {
    "whoop": {
      "command": "npx",
      "args": ["-y", "whoop-mcp-unofficial"]
    }
  }
}
  1. 01

    Create a WHOOP Developer app.

  2. 02

    Use redirect URI http://127.0.0.1:3000/callback.

  3. 03

    Run setup, auth and doctor before connecting an agent.

Data Availability

Available

Recovery score, HRV, RHR, SpO2, skin temperature

Available when WHOOP returns a scored recovery.

Available

Sleep sessions, stages and performance

All scored sleep records.

Available

Cycles, day strain and kilojoules

Physiological cycle records.

Available

Workouts, sport and heart-rate zones

All recorded workouts exposed by the public API.

Available

Profile and body measurements

Height, weight and max heart rate.

Not exposed

Continuous heart-rate or live BLE telemetry

Not exposed by the public WHOOP API; this connector is not a Bluetooth listener.

Agent 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 and Resources

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 Model

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.