# WHOOP MCP for AI Agents AI Agent Connect > WHOOP lets you pull your wearable health data directly into your AI agent. You can check your recovery scores, sleep stages, and workout strain without jumping between apps. It connects your WHOOP account so you can ask your agent about your HRV trends, resting heart rate, and body measurements to better understand your physical readiness. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_uFyFM8HK5BcqmBDcmonnVnJPILN8SSDgtncUvmg3/ai-agent-connect - **Tags:** wearable-tech, sleep-tracking, recovery-metrics, heart-rate-monitoring, health-analytics, biometrics ## Description Imagine you are in the middle of planning your training block for the next month. Usually, you have to open the WHOOP app, scroll through weeks of data, and try to remember how much strain you actually took on during those heavy lifting sessions. This Connector changes that by putting all that data into a single conversation. You can just ask your agent what your recovery looks like today or if you are actually ready for a high-intensity workout. It pulls in everything from your sleep quality and HRV to your specific heart rate zones. It is built for people who want to make sense of their biometrics without the manual data entry. By listing this on Vinkius, it becomes part of a larger ecosystem where you can coordinate your health data alongside your other daily tasks. You get a clear picture of your body's status in real-time, making it easier to decide when to push hard and when to take a rest day. You can see how your sleep balance affects your next day's performance or how your resting heart rate has trended over the last month. It turns your wearable into a queryable database for your daily life. ## Tools ### get_body_measurement Pulls your physical metrics like weight and height to track body composition. It helps you keep your physical stats organized in one place. ### get_cycle_recovery Extracts the recovery score, sleep balance, and HRV for a specific cycle. This is the fastest way to check your readiness for today. ### get_sleep_by_id Gets detailed sleep performance, including respiratory rate and specific disturbances. Use this to dive into the specifics of a single night. ### get_cycle Retrieves the full set of recovery, strain, and heart rate metrics for a specific 24-hour period. This helps you see your overall physical status for any day in the past. ### get_sleep Fetches your sleep duration and stages for a selected period. This helps you see if your rest quality is improving over time. ### get_workouts Lists all your recorded workouts within a specific timeframe. Use this to see your total volume and strain for the week. ### get_cycle_sleep Provides the sleep duration, stages, and performance percentage for a specific cycle. This gives you a quick summary of your rest. ### get_cycles Fetches a list of historical 24-hour cycles with date filters for tracking long-term trends. You can browse through multiple days of data at once. ### get_profile Verifies your connection and retrieves your user ID and basic profile information. Use this to make sure your agent is correctly linked to your account. ### get_recovery Pulls your recovery scores and HRV data over a specific date range. It is useful for seeing how your body is bouncing back over several days. ### get_workout Retrieves specific workout details like calories burned, strain, and heart rate zones. It gives you a clear breakdown of a single training session. ## Prompt Examples **Prompt:** ``` How was my sleep last night? ``` **Response:** ``` ### Sleep Summary **Total Duration:** 7h 45m **Sleep Performance:** 85% | Stage | Duration | | :--- | :--- | | Light | 3h 20m | | Deep | 2h 10m | | REM | 1h 45m | | Awake | 30m | **Disturbances:** 2 **Respiratory Rate:** 14 breaths/min ``` **Prompt:** ``` What's my recovery score today? ``` **Response:** ``` ### Today's Recovery Your recovery score is **78% (Good)**. * **Resting HR:** 52 bpm * **HRV:** 68ms * **Sleep Balance:** 8h 12m **Status:** You are well recovered and ready for high strain today. ``` **Prompt:** ``` Show me my workouts from this week. ``` **Response:** ``` ### Weekly 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 ### Pull daily recovery scores Get your current recovery status and HRV instantly. ### Check sleep stages See how much deep, light, and REM sleep you got last night. ### Review workout strain Look up the intensity and heart rate zones for past exercises. ### Track body measurements Keep a record of your weight and height over time. ### Analyze sleep disturbances Find out how many times you woke up or had respiratory issues. ## Use Cases ### Deciding on training intensity An athlete asks if they are ready for a heavy leg day. The agent uses get_cycle_recovery to check the HRV and recovery score to give a thumbs up or down. ### Reviewing weekly volume A coach wants to see the strain for the last three workouts. The agent uses get_workouts to list the recent history and calculate the total strain. ### Monitoring sleep trends A user asks how their sleep has been this week. The agent uses get_sleep to summarize the last seven days and identifies any major disturbances. ### Tracking body progress A fitness enthusiast asks what their weight was last month. The agent uses get_body_measurement to find the old record and compare it to today. ## Benefits - No more app switching. You can check your recovery score and HRV trends instantly without opening the WHOOP app. - Better training decisions. Use get_cycle_recovery to see if your sleep balance supports a high-strain workout today. - Detailed sleep analysis. Get specific data on sleep disturbances and respiratory rates using get_sleep_by_id. - Long-term health tracking. Use get_recovery and get_workouts to see how your strain and recovery have changed over months. - Remote coaching capabilities. Coaches can pull workout data using get_workouts to monitor athlete progress from anywhere. ## How It Works The bottom line is you get instant access to your wearable health metrics through a natural chat interface. 1. Subscribe to the WHOOP MCP on Vinkius. 2. Enter your WHOOP Client ID, Client Secret, and Access Token in your AI client. 3. Ask your agent questions about your sleep, recovery, or workouts. ## Frequently Asked Questions **Can I see my WHOOP recovery score with this Connector?** Yes, it pulls your daily recovery score and HRV trends directly into your chat. You can ask about today's score or look at your history over the last few days. **How do I connect my WHOOP data to my AI?** You just need to provide your Client ID and Client Secret in your AI client settings. Once connected, your agent can access all your wearable metrics. **Can I track my sleep stages using the WHOOP MCP?** Yes, it can pull detailed sleep performance and specific stages like REM and deep sleep. It also provides data on sleep disturbances and your respiratory rate. **Is this for coaches who manage multiple athletes?** Yes, coaches can use it to monitor the workload and recovery of their clients. It helps you see how athletes are handling their strain and how well they are sleeping. **Can I see my body measurements?** Yes, the Connector can pull your weight and height data from your WHOOP profile. This is great for tracking your physical progress alongside your training data. **Does it work with my workout history?** It can pull specific workout details including strain, heart rate zones, and calories. You can ask your agent to summarize your recent training sessions. **How do I get WHOOP API credentials?** Visit [**developer.whoop.com**](https://developer.whoop.com/), create an app to get a Client ID and Client Secret. Then complete the OAuth2 flow to obtain an Access Token. All three are required for API access. **What is a WHOOP cycle?** A WHOOP cycle represents a 24-hour period combining your sleep, strain and recovery data. Each cycle starts when you wake up and includes the previous night's sleep, the day's strain, and your recovery score for the next day. **How much historical data can I access?** You can access all historical data recorded by your WHOOP device. Use the start and end date parameters (ISO 8601 format) to filter results. Pagination returns up to 25 records per request; use the nextToken to retrieve more. **Does the API include heart rate data?** Yes! Heart rate data (average and max) is included in the cycle, workout and recovery responses. There's no dedicated heart rate endpoint, but the data is nested within these resources.