# WHOOP MCP

> WHOOP connects your wearable health data—sleep, recovery, strain, and workouts—directly into your agent. Get instant answers about body metrics, sleep stages, or training load without digging through apps or spreadsheets. This MCP lets you ask natural language questions about your full 24-hour cycle data, making advanced biometrics immediately accessible to any AI client.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** wearable-tech, sleep-tracking, recovery-metrics, heart-rate-monitoring, health-analytics, biometrics

## Description

Managing physical performance is complex; it's not just about logging miles run or hours slept. It requires cross-referencing metrics like Heart Rate Variability (HRV), recovery scores, and deep sleep duration against your recent training load.

This MCP connects your WHOOP account to any AI client, letting you query this sophisticated health data through conversation. Your agent reads the raw numbers—whether it's tracking body measurements or analyzing a specific workout session—and synthesizes them into clear insights for you. You don't have to jump between apps to piece together what 'good recovery' really means.

It’s designed for people who need actionable data, not just graphs. When you connect this through Vinkius, your agent can access everything from general cycle summaries to specific sleep stages and even historical performance trends with simple prompts. You get a single source of truth about how your body is responding day-to-day.

## Tools

### get_body_measurement
Retrieves current physical metrics like height, weight, and maximum heart rate associated with your profile.

### get_cycle
Gets a complete 24-hour data summary, including sleep, recovery, strain, and general heart rate information for one specific cycle ID.

### get_cycle_recovery
Fetches detailed recovery metrics, including HRV and the calculated score, for a single WHOOP cycle period.

### get_cycle_sleep
Provides deep analysis of sleep data for a specific cycle, detailing stages like light, deep, REM, and overall performance percentage.

### get_cycles
Retrieves WHOOP cycle data over a date range, allowing you to paginate and review many days of combined recovery, strain, and sleep metrics.

### get_profile
Verifies your connection and returns basic user profile information needed for other endpoints.

### get_recovery
Gets recovery data across a specified date range, useful for tracking trends over weeks or months.

### get_sleep
Retrieves sleep data over a date range, allowing you to view historical performance and stage metrics.

### get_sleep_by_id
Focuses on one specific night's sleep record, giving details on stages, disturbances, and respiratory rate.

### get_workout
Pulls a single workout session by ID, providing strain score, heart rate zones, duration, and calories burned.

### get_workouts
Gets all workout data within a specified date range, supporting pagination for comprehensive history review.

## Prompt Examples

**Prompt:** 
```
Show me my recovery score from today.
```

**Response:** 
```
Today's recovery: 78% (Good). Resting HR: 52 bpm, HRV: 68ms, sleep balance: 8h 12m. You're well recovered and ready for high strain today.
```

**Prompt:** 
```
How did I sleep last night?
```

**Response:** 
```
Last night's sleep: 7h 45m total. Sleep performance: 85%. Light sleep: 3h 20m, Deep sleep: 2h 10m, REM: 1h 45m, Awake: 30m. Respiratory rate: 14 breaths/min. 2 disturbances.
```

**Prompt:** 
```
Show me my workouts from this week.
```

**Response:** 
```
This week's workouts: 1. Running (45min, strain 14.2, avg HR 152, 520 cal) — 2. Weight Training (60min, strain 12.8, avg HR 138, 410 cal) — 3. Cycling (30min, strain 10.5, avg HR 145, 350 cal). Total weekly strain: 37.5.
```

## Capabilities

### Analyzing Sleep Performance
Retrieve detailed records showing light, deep, REM sleep duration, and overall sleep performance for specific nights.

### Tracking Daily Recovery Status
Get a snapshot of recovery scores, resting heart rate, HRV, and sleep balance for any given 24-hour cycle period.

### Reviewing Training History
Pull specific workout records, detailing strain score, average heart rate zones, duration, and calories burned during a session.

### Monitoring Body Metrics
Access essential physical data like height, weight, and maximum heart rate alongside your performance metrics.

## Use Cases

### Diagnosing Overtraining Syndrome
A coach needs to know if a client's performance is declining due to poor rest. The agent uses `get_cycles` and compares the resulting strain scores against the historical low recovery metrics pulled via `get_cycle_recovery`, immediately flagging potential overtraining patterns.

### Planning Travel-Related Workouts
You're packing for a trip and need to know your baseline fitness. You ask the agent, 'Based on my last 10 workouts via `get_workouts`, what is my average sustained heart rate zone performance?' This helps you plan appropriate activity levels.

### Reviewing Sleep Debt
You suspect your sleep quality has worsened. You use `get_sleep` for the past two weeks and ask: 'Identify any nights where my REM sleep was less than 1 hour.' The agent analyzes the data points from multiple records.

### Post-Injury Workload Management
A physical therapist needs to ensure a patient isn't overdoing it. They use `get_cycle` and ask: 'How was my recovery on days I used the rehab machine?' The agent compares daily activity logs against core biometrics.

## Benefits

- Instead of manually checking sleep logs, use `get_sleep` to pull all historical data for a date range and ask your agent: 'Show me my deep sleep percentage trend over the last month.'
- Stop guessing about readiness. Use `get_cycle_recovery` to check immediate recovery scores (HRV, rest HR) right after an intense workout, letting you decide if you can push harder or need a rest day.
- Cross-reference your physical health with activity using `get_workout`. You can ask: 'What was my average strain score during my run last Tuesday?'
- When tracking long-term trends, use `get_recovery` and `get_sleep` together. Your agent compiles the narrative: 'My recovery scores drop every time I hit 30+ miles in a week.'
- Need to check basic stats? The `get_body_measurement` tool ensures your agent has up-to-date metrics like weight or max heart rate for accurate comparisons.

## How It Works

The bottom line is that you just talk to your agent about your health metrics instead of navigating multiple dashboards or API endpoints.

1. Subscribe to this MCP and provide your required WHOOP Client ID, Secret, and Access Token.
2. Connect the credentialed MCP to your preferred AI client (Claude, Cursor, etc.).
3. Ask your agent a specific question, like 'What was my recovery score two days ago?' The MCP executes the request and returns the precise data.

## Frequently Asked Questions

**How do I track long-term recovery data using the WHOOP MCP?**
You use the `get_recovery` tool, which lets you define a date range. This allows your agent to pull all your recovery scores over weeks or months so you can spot trends.

**Can I check my sleep stages for last night with WHOOP MCP?**
Yes. The `get_sleep` tool provides historical data, and the specialized `get_cycle_sleep` tool gives a deep dive into light, deep, REM, and awake time for any specific cycle.

**What kind of workouts can I analyze with WHOOP MCP?**
The `get_workouts` tool pulls comprehensive data across a date range. You get details like strain score, average heart rate zones, duration, and calories burned for each session.

**Do I need to use `get_profile` every time I connect WHOOP MCP?**
No, you only run the `get_profile` tool if your agent needs to verify basic user details or authentication status before calling other endpoints.

**Can I see my body measurements and recovery data together? (WHOOP MCP)**
Yes. You can combine information by using `get_body_measurement` for static stats, then correlating those with dynamic readings from `get_cycle_recovery` to get a full picture.