oura-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@oura-mcp How did I sleep last night?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@louis030195/oura-mcp
Dead simple MCP (Model Context Protocol) server for Oura Ring. Get your sleep, readiness, and activity data directly from Claude, ChatGPT, or any LLM that supports MCP.
π Support This Project
If you find this MCP server useful, please consider supporting its development!
π Click here to support this project
Your support helps maintain and improve this tool. Thank you! π
Features
π΄ Sleep data (score, REM, deep, light sleep stages)
β‘ Readiness score (HRV, resting HR, body temperature)
π Activity data (steps, calories, activity score)
β€οΈ Heart rate monitoring
Related MCP server: Oura MCP Server
Installation
Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"oura": {
"command": "npx",
"args": ["-y", "@louis030195/oura-mcp"],
"env": {
"OURA_API_KEY": "your-oura-api-key"
}
}
}
}Claude Code
# Install globally in user scope with API key
claude mcp add -s user oura npx -e OURA_API_KEY=your-oura-api-key -- -y @louis030195/oura-mcpGet Your Oura API Key
Click "Create New Personal Access Token"
Copy your token (starts with something like
4SKHEL...)
Usage
Once configured, you can use natural language to access your Oura data:
"How did I sleep last night?"
"Show me my sleep data for the past week"
"What's my readiness score today?"
"How many steps did I take yesterday?"
"Show my heart rate data from last week"
Tools
oura_sleep
Get daily sleep data including sleep score, sleep stages (REM, deep, light), efficiency, and timing.
Parameters:
start_date(required): Start date in YYYY-MM-DD formatend_date(optional): End date in YYYY-MM-DD format
oura_readiness
Get daily readiness score, HRV balance, resting heart rate, and body temperature deviation.
Parameters:
start_date(required): Start date in YYYY-MM-DD formatend_date(optional): End date in YYYY-MM-DD format
oura_activity
Get daily activity data including steps, calories burned, and activity score.
Parameters:
start_date(required): Start date in YYYY-MM-DD formatend_date(optional): End date in YYYY-MM-DD format
oura_heartrate
Get heart rate data over time.
Parameters:
start_date(required): Start date in YYYY-MM-DD formatend_date(optional): End date in YYYY-MM-DD format
Development
# Clone the repo
git clone https://github.com/louis030195/oura-mcp.git
cd oura-mcp
# Install dependencies
npm install
# Build
npm run build
# Run locally
OURA_API_KEY=your-api-key npm startLicense
MIT
Author
Available Tools
4 toolsoura_activityB
Get daily activity data including steps, calories, and activity score
Inputs: start_date (required), end_date.
oura_heartrateC
Get heart rate data over time
Inputs: start_date (required), end_date.
oura_readinessB
Get daily readiness score, HRV balance, resting heart rate, and body temperature
Inputs: start_date (required), end_date.
oura_sleepC
Get daily sleep data including sleep score, sleep stages (REM, deep, light), and sleep duration
Inputs: start_date (required), end_date.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 4 tools
Each tool targets a distinct Oura data domain (sleep, readiness, activity, heart rate), so an agent can generally tell them apart. There is slight potential overlap because readiness includes resting heart rate and HRV, while heartrate returns heart rate over time, but the descriptions make the intended distinction clear enough.
All four tools follow the same predictable oura_<noun> pattern (oura_sleep, oura_readiness, oura_activity, oura_heartrate). There are no mixed conventions, camelCase, or inconsistent verbs.
Four tools is a reasonable, focused set for a read-only Oura data server covering the main daily metrics. It is slightly thin compared to the full breadth of Oura data types, but not problematic.
The core daily metrics (sleep, readiness, activity, heart rate) are covered, but obvious Oura data surface areas are missing, such as workouts, tags, sessions, and SpO2. The server is read-only, which is acceptable for Oura's API, but the absence of a workout or tag endpoint is a notable gap.
Related MCP Connectors
Multi-tenant hosted MCP server for Oura Ring β 21 read-only tools, OAuth per user.
Connect your Oura Ring account securely in minutes. Enable authorized access to your sleep, activiβ¦
Hosted Apple Health MCP: workouts, sleep and HRV in ChatGPT, Claude, Gemini, Grok. Free, no export.
Connect your Oura Ring account and enable access to your wellness data in apps and automations. Inβ¦
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables querying sleep, readiness, and resilience data from the Oura API via the Model Context Protocol (MCP), allowing natural language interaction and seamless integration with tools like Claude.639MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to Oura Ring health data, including sleep, activity, readiness, and stress metrics via the Model Context Protocol. It enables users to query their personal biometric information and daily health summaries through natural language in MCP-compatible clients.ISC
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to query Oura Ring health data (sleep, readiness, activity, heart rate, SpO2, stress) via a remote MCP server.-
- AlicenseAqualityCmaintenanceMCP server for the Oura Ring API v2, enabling natural language queries about sleep, readiness, activity, heart rate, and more.2974 npm1MIT