
A community MCP server, not by Oura: your agent reads your Oura Ring sleep, readiness and activity data and looks for patterns.
by mitchhankins01· Health & fitnessUnclaimed · Yours? Claim it
About
A community-built MCP server by Mitch Hankins (mitchhankins01) for the Oura Ring. It isn't made by Oura. It lets your agent read your sleep, readiness, activity and other Oura data through Oura's own API, formatted so it's easy to read, and work out trends, comparisons and unusual readings from it. What you can do with it - Check last night's sleep: stages, efficiency, heart rate, HRV and what went into your score - See today's readiness score and its contributors - Look at activity, workouts, meditation sessions, heart rate, stress, SpO2 and more - Find unusual readings, compare this week with last, and follow your HRV trend - Compare days with and without one of your Oura tags, and see what goes with your best nights of sleep - Start from its built-in prompts for a weekly review, a recovery check or a sleep review How it connects It runs on your machine with npx oura-ring-mcp and needs Node.js 18 or newer. It needs your Oura sign-in in one of two ways: - OAuth: create an OAuth application in Oura's developer portal, set OURA_CLIENT_ID and OURA_CLIENT_SECRET, and run npx oura-ring-mcp auth once. It saves your credentials in ~/.oura-mcp/credentials.json. Give the server the same client ID and secret if you want it to refresh the token itself. - A personal access token in OURA_ACCESS_TOKEN. Oura now marks personal access tokens as deprecated, so OAuth is the route to rely on. The server won't start if it finds neither, and the install steps here don't add the token for you. Good to know - It only reads your Oura data. It has no tools that change anything in your account. - The maker also documents running it as a remote server you deploy and host yourself. - It works with your own wearable data. What your agent says about it isn't medical advice; talk to a doctor about any health concern.
Plugins people install alongside Oura Ring MCP.
4 images
Once it’s added
“How did I sleep last night?”
“What's my readiness today?”
“Compare my sleep this week vs last week.”
“Does alcohol affect my sleep quality?”
“Is my HRV improving or declining?”
“Are there any unusual readings in my data?”
Before you add it
Reads only
Sleep, readiness and activity, with score contributors · Heart rate, HRV, stress, SpO2 and other Oura metrics · Workouts, meditation sessions and your tags · Trends, comparisons and unusual readings, worked out from your data
From people who use it
Step by step
Nothing new reaches your agent until a person has looked at it.
Scanned on every change, and again when our rules improve.
Runs on your machine.
claude_desktop_config.json{
"mcpServers": {
"oura-ring-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Runs on your machine.
Add to VS Codecode --add-mcp '{"name":"oura-ring-mcp","command":"npx","args":["-y","[email protected]"]}'copilot mcp add oura-ring-mcp -- npx -y [email protected]
Runs on your machine.
Add to Cursor.cursor/mcp.json{
"mcpServers": {
"oura-ring-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Runs on your machine.
claude mcp add oura-ring-mcp -- npx -y [email protected]
Runs on your machine.
codex mcp add oura-ring-mcp -- npx -y [email protected]
Runs on your machine.
~/.gemini/config/mcp_config.json{
"mcpServers": {
"oura-ring-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Runs on your machine.
gemini mcp add oura-ring-mcp npx -y [email protected]
Runs on your machine.
Runs on your machine.
opencode mcp add oura-ring-mcp -- npx -y [email protected]
Runs on your machine.
~/.hermes/config.yaml{
"mcp_servers": {
"oura-ring-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}OURA_ACCESS_TOKENOptionalSecretOura Personal Access Token (get from cloud.ouraring.com/personal-access-tokens)OURA_CLIENT_IDOptionalOAuth Client ID (alternative to access token, from developer.ouraring.com)OURA_CLIENT_SECRETOptionalSecretOAuth Client Secret (required with OURA_CLIENT_ID)Scanned and passed · checked just now
No reviews yet. Used Oura Ring MCP? Say how it went.
Write a reviewPlugins people install alongside Oura Ring MCP.
Medplum's hosted MCP server for healthcare developers: your agent reads and changes the FHIR data on your Medplum server.
Community MCP server, not by Apple: your agent answers questions about your sleep, workouts and heart data from a local Apple Health export.
A community MCP server, not by Hevy: your agent reads, analyzes and logs your Hevy workouts, routines and body measurements.
Lets your agent read and plan your Intervals.icu training: activities, fitness and fatigue, wellness, calendar workouts and gear.
Nobody has shared how they use Oura Ring MCP yet.
Security scan
Passed
Safe to install in every agent it supports. Runs on your machine.