Oura Connector for AI agents.
7 live capabilities
Access your wearable health and recovery data through natural conversation.
Waiting for input…
Why people use Oura
Oura for Wearable Health Data Analytics
With this Connector, you just ask your agent. It pulls the latest metrics from your Oura Ring and gives you a summary instantly. You get to see the connection between your training and your recovery without ever leaving your chat window.
What Vinkius changes
You get a conversational interface for your wearable health data.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking workout readiness
An athlete asks their agent if they should hit a PR today.
- Real-world use case 02
Correlating habits and sleep
A biohacker wants to know if caffeine affects their sleep.
- Real-world use case 03
Weekly activity summary
A user wants to see their progress.
Complete set · 7capabilities
The complete Oura capability set.
These are the exact actions your AI can choose when you ask it to work with Oura.
01—04
4 capabilities in this set.
Part of 7 available through Oura.
- 01 Capability
Get sessions
Get overall scores, sleep metrics, and readiness for specific dates. This helps you see a high-level summary of your health trends at a glance.
- 02 Capability
Get sleep
Fetch detailed sleep stages and efficiency for a date range. You can see exactly how much time you spent in deep or REM sleep.
- 03 Capability
Get tags
Retrieve your manual mood, energy, and behavior entries. This lets you see how your habits correlate with your physical metrics.
- 04 Capability
Get workouts
List all logged workouts including type and duration. Use this to review your training history and see your total volume.
05—07
3 capabilities in this set.
Part of 7 available through Oura.
- 05 Capability
Get activity
Pull daily steps, calories, and activity goals. You can quickly check if you met your movement targets for the day.
- 06 Capability
Get heart rate
Access high-frequency heart rate and HRV samples. This is useful for looking at specific heart rate spikes during intense activity.
- 07 Capability
Get readiness
Get your current readiness score and recovery status. See if your body is recovered enough for a heavy training session.
Set up in minutes
One URL. Then ask Oura to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Oura 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_svxDJKGG804lvGTAEC0foQcbhTCnpIbawWkxNGPv/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 Oura, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Oura for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_svxDJKGG804lvGTAEC0foQcbhTCnpIbawWkxNGPv/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 Oura URL.
- Step 03
Save and start
Save the connection and enable Oura in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"oura": {
"url": "https://edge.vinkius.com/vk_preview_svxDJKGG804lvGTAEC0foQcbhTCnpIbawWkxNGPv/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 Oura
Open Agent mode in chat and ask: "Using Oura, help me...". 7 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"oura": {
"url": "https://edge.vinkius.com/vk_preview_svxDJKGG804lvGTAEC0foQcbhTCnpIbawWkxNGPv/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 Oura
Ask Copilot: "Using Oura, help me...". 7 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"oura": {
"url": "https://edge.vinkius.com/vk_preview_svxDJKGG804lvGTAEC0foQcbhTCnpIbawWkxNGPv/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 Oura
Open Cascade and ask: "Using Oura, help me...". 7 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"oura": {
"url": "https://edge.vinkius.com/vk_preview_svxDJKGG804lvGTAEC0foQcbhTCnpIbawWkxNGPv/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 Oura
Ask Cline: "Using Oura, help me...". 7 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add oura --transport http "https://edge.vinkius.com/vk_preview_svxDJKGG804lvGTAEC0foQcbhTCnpIbawWkxNGPv/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 Oura
Ask Claude: "Using Oura, show me...". 7 tools are ready
Where the request belongs
Work Oura can move forward.
This is for biohackers, endurance athletes, and health-conscious people who want to see the connection between their habits and their physical recovery without manual data entry.
Biohacker
Correlates mood and energy tags with sleep quality to optimize daily habits.
Endurance Athlete
Monitors HRV and readiness scores to decide when to push hard or take a rest day.
Wellness Enthusiast
Tracks sleep trends and activity goals to maintain a healthy lifestyle.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsWHOOP
Track your WHOOP health metrics. workouts, sleep, recovery, strain, HRV and body measurements from any 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
Access Fitbit health data via AI. query activities, sleep, heart rate, SpO2, body weight, and nutrition logs in natural conversation.
Polar
Access your Polar Flow data. training sessions, daily activity, sleep metrics, and physical info directly from your AI agent.
Sleep Debt Tracker
Quantify accumulated sleep debt, identify trends, and predict recovery timelines.
Kippy
Track GPS locations of pets and loved ones in real time with wearable devices that send alerts when they leave safe zones.
Bring your own AI
Change the model, client or framework. Keep Oura 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 Oura.
The practical details behind the request, access and result.
Can I use the Oura MCP with Claude?
Yes, you can connect this Connector to Claude or any other MCP-compatible client to talk to your Oura data.
How do I connect my Oura Ring to my agent?
You just need to subscribe to the Connector on Vinkius and provide your Oura Personal Access Token in the settings.
Can I see my sleep stages with this?
Yes, the Connector can pull your specific sleep stages, including REM, deep, and light sleep, for any date range you choose.
Does the Oura MCP show my heart rate?
It can retrieve high-frequency heart rate samples and HRV data, which is great for analyzing your heart's response to activity.
Can I check my workout history?
Yes, you can ask your agent to list all your logged workouts, including the type of exercise, duration, and calories burned.
Is my Oura data private?
Your data remains private. The Connector simply acts as a bridge to fetch the information you request from your Oura account.
How do I get an Oura Personal Access Token?
Log in to your Oura account at cloud.ouraring.com, create a personal access token in your account settings. The token gives access to your sleep, activity, readiness and health data.
What health data is available?
Sleep (score, stages, efficiency), Activity (steps, calories, MET), Readiness (score, HRV, RHR, temperature), Tags (mood, energy, behaviors), Workouts (type, duration, HR zones) and Heart Rate (5-min samples).
How far back can I access data?
You can access all historical data recorded by your Oura Ring. Use start_date and end_date parameters to filter results. Data is paginated with a nextToken for large date ranges.
One connection away
Give your agent a direct line to Oura.
Connect Oura once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available