WHOOP Connector for AI agents.
11 live capabilities
Track wearable recovery scores and sleep data to optimize your daily training.
Waiting for input…
Why people use WHOOP
WHOOP for Wearable Health Data Analysis
This Connector brings all that info into one place. You can just ask your agent questions like 'How did I sleep?' and get a summary of your stages and disturbances. It turns a manual search into a quick conversation.
What Vinkius changes
You get instant access to your wearable health metrics through a natural chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Deciding on training intensity
An athlete asks if they are ready for a heavy leg day.
- Real-world use case 02
Reviewing weekly volume
A coach wants to see the strain for the last three workouts.
- Real-world use case 03
Monitoring sleep trends
A user asks how their sleep has been this week.
Complete set · 11capabilities
The complete WHOOP capability set.
These are the exact actions your AI can choose when you ask it to work with WHOOP.
01—04
4 capabilities in this set.
Part of 11 available through WHOOP.
- 01 Capability
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.
- 02 Capability
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.
- 03 Capability
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.
- 04 Capability
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.
05—08
4 capabilities in this set.
Part of 11 available through WHOOP.
- 05 Capability
Get sleep
Fetches your sleep duration and stages for a selected period. This helps you see if your rest quality is improving over time.
- 06 Capability
Get workouts
Lists all your recorded workouts within a specific timeframe. Use this to see your total volume and strain for the week.
- 07 Capability
Get cycle sleep
Provides the sleep duration, stages, and performance percentage for a specific cycle. This gives you a quick summary of your rest.
- 08 Capability
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.
09—11
3 capabilities in this set.
Part of 11 available through WHOOP.
- 09 Capability
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.
- 10 Capability
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.
- 11 Capability
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.
Set up in minutes
One URL. Then ask WHOOP to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use WHOOP from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_uFyFM8HK5BcqmBDcmonnVnJPILN8SSDgtncUvmg3/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it WHOOP, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable WHOOP for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_uFyFM8HK5BcqmBDcmonnVnJPILN8SSDgtncUvmg3/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the WHOOP URL.
- Step 03
Save and start
Save the connection and enable WHOOP in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"whoop": {
"url": "https://edge.vinkius.com/vk_preview_uFyFM8HK5BcqmBDcmonnVnJPILN8SSDgtncUvmg3/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using WHOOP
Open Agent mode in chat and ask: "Using WHOOP, help me...". 11 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"whoop": {
"url": "https://edge.vinkius.com/vk_preview_uFyFM8HK5BcqmBDcmonnVnJPILN8SSDgtncUvmg3/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using WHOOP
Ask Copilot: "Using WHOOP, help me...". 11 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"whoop": {
"url": "https://edge.vinkius.com/vk_preview_uFyFM8HK5BcqmBDcmonnVnJPILN8SSDgtncUvmg3/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using WHOOP
Open Cascade and ask: "Using WHOOP, help me...". 11 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"whoop": {
"url": "https://edge.vinkius.com/vk_preview_uFyFM8HK5BcqmBDcmonnVnJPILN8SSDgtncUvmg3/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using WHOOP
Ask Cline: "Using WHOOP, help me...". 11 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add whoop --transport http "https://edge.vinkius.com/vk_preview_uFyFM8HK5BcqmBDcmonnVnJPILN8SSDgtncUvmg3/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using WHOOP
Ask Claude: "Using WHOOP, show me...". 11 tools are ready
Where the request belongs
Work WHOOP can move forward.
This is for athletes who need to balance high performance with physical limits, and coaches who need to monitor the health of a group of people without checking multiple individual profiles.
Performance Athlete
Uses the Connector to check if their recovery score is high enough to hit a personal best in training.
Health Coach
Queries workout strain and sleep trends for multiple clients to adjust weekly training loads.
Fitness Enthusiast
Tracks long-term HRV trends and body measurements to see how lifestyle changes affect their body.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsPolar
Access your Polar Flow data. training sessions, daily activity, sleep metrics, and physical info directly from your AI agent.
Withings
Access comprehensive health and fitness data. track weight, blood pressure, sleep cycles, steps, workouts, and heart rate directly from Withings devices.
Fitbit
Analyze your health and fitness data. track Active Zone Minutes, activity logs, blood glucose, and body goals directly from your AI agent.
Oura
Access your Oura Ring health data. sleep, activity, readiness, HRV, heart rate and workout metrics from any AI agent.
Recovery Readiness Score
Evaluate training readiness and optimal intensity based on sleep, soreness, stress, and motivation.
Recovery Score
Estimate muscle recovery and physiological readiness based on training load, sleep quality, and rest frequency.
Bring your own AI
Change the model, client or framework. Keep WHOOP connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about WHOOP.
The practical details behind the request, access and result.
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, 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.
One connection away
Give your agent a direct line to WHOOP.
Connect WHOOP once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available