WHOOP MCP. Translate Biometrics into Actionable Insights
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.
Give Claude and any AI agent real-world access
Retrieve detailed records showing light, deep, REM sleep duration, and overall sleep performance for specific nights.
Get a snapshot of recovery scores, resting heart rate, HRV, and sleep balance for any given 24-hour cycle period.
Pull specific workout records, detailing strain score, average heart rate zones, duration, and calories burned during a session.
Access essential physical data like height, weight, and maximum heart rate alongside your performance metrics.
Ask an AI about this
Waiting for input…
What AI agents can do with WHOOP MCP: 11 Health Metric Tools
Use these eleven specific tools to analyze every aspect of your WHOOP data, from daily recovery scores to historical workout performance.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using WHOOP MCPGet 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...
Get Cycle Recovery
Fetches detailed recovery metrics, including HRV and the calculated score, for a...
Get Cycle Sleep
Provides deep analysis of sleep data for a specific cycle, detailing stages like...
Get Cycles
Retrieves WHOOP cycle data over a date range, allowing you to paginate and review...
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...
Get Sleep By Id
Focuses on one specific night's sleep record, giving details on stages...
Get Workout
Pulls a single workout session by ID, providing strain score, heart rate zones...
Get Workouts
Gets all workout data within a specified date range, supporting pagination for...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with WHOOP, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by WHOOP. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The struggle of assembling a complete performance picture
Right now, figuring out your body’s true state is manual work. You might log a workout in one app, check sleep data on another dashboard, and look up recovery scores via a third source. Then you open a spreadsheet to try and manually correlate if the effort justified the rest.
With this MCP, you skip the dashboards entirely. You just tell your agent what you want to know—'Was my body ready for that run?' The system handles all the cross-referencing using tools like `get_workout` and `get_cycle_recovery`, giving you one immediate answer instead of five tabs to check.
WHOOP MCP: Performance Data in Conversation
The biggest time sink is the constant context-switching. You spend minutes clicking through date ranges, exporting CSVs, and pasting everything into a note just to write down three key takeaways for your coach.
Now, you talk to your agent. It accesses all the relevant data—whether it's pulling specific sleep stages via `get_sleep_by_id` or reviewing multi-day trends with `get_cycles`. The insight comes directly back in plain English.
What WHOOP MCP does for your AI
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.
019d849d-ccc6-7358-844d-2ba0fe0302a7 How to set up WHOOP MCP
The bottom line is that you just talk to your agent about your health metrics instead of navigating multiple dashboards or API endpoints.
Subscribe to this MCP and provide your required WHOOP Client ID, Secret, and Access Token.
Connect the credentialed MCP to your preferred AI client (Claude, Cursor, etc.).
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.
Who uses WHOOP MCP
This MCP serves anyone whose performance depends on understanding their physical limits and recovery. It's for the endurance athlete who needs to know if a heavy training day compromised sleep, the personal trainer monitoring client workload trends, or any bio-curious individual tracking deep biometrics over time.
Using this MCP, you can correlate high workout strain with low recovery scores and poor sleep quality to adjust your training plan.
You monitor a client's trend data over weeks, looking for patterns where resting heart rate or HRV drop off following specific activity levels.
You track your sleep stages and overall body measurements to understand how lifestyle changes affect your deep restorative rest.
Benefits of connecting WHOOP MCP
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.
WHOOP MCP 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.
WHOOP MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Treating data points as standalone facts
Asking your agent, 'What was my sleep score on July 1st?' and getting only a single number without context.
Instead, ask the agent to compare two metrics: 'How did my deep sleep percentage (using get_sleep_by_id) change when I hit a high strain workout (checked with get_workout)?' Context is everything.
Trying to predict future performance
Asking, 'Will I run a marathon next year?' The agent will give vague advice based on limited data.
Focus the query on historical trends. Ask: 'What is my average weekly total strain over the last quarter using get_workouts and get_cycles?' Stick to what the data shows.
Ignoring time constraints
Asking, 'Give me all my stats.' This results in a massive wall of text with no actionable takeaways.
Be specific. Limit the scope: 'Show me my recovery data for the last 14 days using get_recovery and summarize any dips below 60%.'
When to use WHOOP MCP
Use this MCP if your primary need is to synthesize complex, disparate biometrics (sleep stages, strain scores, HRV) into natural language answers. You should use it when you need your agent to compare metrics across time or correlate two different data types—for example, linking a high workout strain score to the following night's low recovery score.
Don’t use this MCP if: 1) You need raw, unaggregated sensor streams (e.g., every single heart rate reading per second). This tool provides summarized, structured API endpoints. 2) Your goal is simply data storage or visualization without asking a question. If you just want to see a chart of your weight over time, a dedicated charting service might be better.
This MCP excels at the 'Why'—it answers why your recovery was low, or why your sleep wasn’t restorative. It requires specific questions that force the agent to cross-reference tools like get_cycle_sleep and get_cycle_recovery against each other.
Frequently asked questions about WHOOP MCP
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.