Oura Ring
Read-only Oura Ring sleep, readiness, activity and heart rate data for AI clients
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- 1 day ago
About Oura Ring
Oura Ring is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.
The server reads your Oura data through the Oura API v2 and never writes to it. Eleven tools return daily sleep scores, per-night sleep periods with stages, efficiency and HRV, readiness with temperature deviation, activity totals, stress, SpO2, resilience, workouts, meditation sessions and heart rate samples. A personal-info tool returns age, weight, height, sex and email.
Daily tools take optional start and end dates and default to the seven days ending today, with ranges capped at 90 days. Heart rate defaults to the last 24 hours with a seven-day maximum. Each result echoes the range it covers so the model knows what today meant, and per-interval series such as 5-minute activity classes are omitted to keep responses small.
Sign-in is OAuth2 because Oura deprecated personal access tokens. You create your own Oura API application, run an auth command once, and the server refreshes tokens itself. Gen3 and Ring 4 owners need an active Oura membership for the API to return data.
Install
Run in a terminal
claude mcp add oura-ring-python-mcp --env OURA_CLIENT_ID='<OURA_CLIENT_ID>' --env OURA_CLIENT_SECRET='<OURA_CLIENT_SECRET>' -- uvx oura-ring-python-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"oura-ring-python-mcp": {
"command": "uvx",
"args": [
"oura-ring-python-mcp"
],
"env": {
"OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"oura-ring-python-mcp": {
"command": "uvx",
"args": [
"oura-ring-python-mcp"
],
"env": {
"OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"oura-ring-python-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"oura-ring-python-mcp"
],
"env": {
"OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"oura-ring-python-mcp": {
"command": "uvx",
"args": [
"oura-ring-python-mcp"
],
"env": {
"OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"oura-ring-python-mcp": {
"command": "uvx",
"args": [
"oura-ring-python-mcp"
],
"env": {
"OURA_CLIENT_ID": "<OURA_CLIENT_ID>",
"OURA_CLIENT_SECRET": "<OURA_CLIENT_SECRET>"
}
}
}
}Configuration
OURA_CLIENT_IDClient ID of your Oura API applicationRequiredOURA_CLIENT_SECRETClient secret of your Oura API applicationRequiredOURA_TOKEN_FILEWhere `oura-ring-python-mcp auth` saved the OAuth tokensOURA_TIMEZONEYour IANA time zone (e.g. Europe/London), so "today" is your day; defaults to the machine'sOURA_CLIENT_IDClient ID of your Oura API applicationRequiredOURA_CLIENT_SECRETClient secret of your Oura API applicationRequiredOURA_TIMEZONEYour IANA time zone (e.g. Europe/London), so "today" is your day; defaults to the machine's
Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- get_personal_info
- Age, weight, height, biological sex, email.
- get_daily_sleep
- Daily sleep score and contributors.
- get_sleep_periods
- Nightly sleep and naps with stages, efficiency, heart rate and HRV.
- get_daily_readiness
- Readiness score, contributors, temperature deviation.
- get_daily_activity
- Activity score, steps, calories, time per level.
- get_daily_stress
- Time in high stress and recovery.
- get_daily_spo2
- Nightly average SpO2 and breathing disturbance index.
- get_daily_resilience
- Resilience level and contributors.
- get_workouts
- Workouts with type, intensity, calories, distance.
- get_sessions
- Meditation, breathing and rest sessions.
- get_heart_rate
- Heart rate samples with min, max and average bpm.
What it does
- Sleep detail
- Daily scores plus nightly stages, efficiency, heart rate and HRV.
- Readiness and resilience
- Scores, contributors and temperature deviation.
- Activity and workouts
- Steps, calories, activity time and workout summaries.
- Stress and SpO2
- Time in high stress and recovery, nightly SpO2 and breathing index.
- Bounded date ranges
- 90-day limit on daily data, 7 days on heart rate.
- Local OAuth tokens
- Tokens are stored in a file readable only by you.
Good for
- Ask how last week's sleep compared with readiness
- Summarise workouts and recovery over a month
- Look for patterns between stress and sleep quality
- Pull heart rate for a specific day for a health review
Pricing
Open source
Open source; requires an Oura account and, for Gen3/Ring 4, an Oura membership
Prices change. Check oura-ring-python-mcp.readthedocs.io before you buy.
Oura Ring FAQ
Can it change my Oura data?
No. Access is read-only.
What credentials do I need?
An Oura API application client ID and secret, plus a one-time OAuth sign-in.
How do I run it?
From PyPI with uvx oura-ring-python-mcp, from a clone with uv, or as a Docker container.
Is a membership required?
Yes for Gen3 and Oura Ring 4 users, per the docs.
Is Oura Ring free?
Yes. Oura Ring is open source, so you can use and self-host it for free.
How do I add Oura Ring to Claude Code?
Run this command in your terminal: claude mcp add oura-ring-python-mcp --env OURA_CLIENT_ID='<OURA_CLIENT_ID>' --env OURA_CLIENT_SECRET='<OURA_CLIENT_SECRET>' -- uvx oura-ring-python-mcp
What are the best alternatives to Oura Ring?
The closest alternatives to Oura Ring are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).
Alternatives to Oura Ring

Tooluniverse
MCP serverMCP server giving AI agents access to thousands of scientific research tools
Runs locally- Open source
- 1.8K GitHub stars
- Health and science

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation
Later Stages
MCP serverCalifornia senior living and care provider records from state licensing and Medicare
- 6 tools
- Remote
- Free
- Health and science
MedXpert 标准检索连接器
MCP serverRead-only local index of medical-device standards with official links, no standard text
Runs locally- 4 tools
- Free
- Legal and government
MedXpert 全球法规连接器 (reg-connector)
MCP serverRead-only local MCP server over a bundled medical-device regulation knowledge base
Runs locally- 7 tools
- Free
- Legal and government

Splyt
MCP serverLet Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep
- Remote
- Free
- Health and science