Oura Ring MCP server
io.github.AntVsl/oura-mcp·v0.4.2Sleep, readiness, HRV, resting heart rate, activity and stress from your Oura Ring
0 stars35 downloads/wk
Reviews
Write oneNobody has reviewed Oura Ring yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Oura Ring tools (11)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_activityАктивность: оценка, шаги, активные и общие калории. По умолчанию — последние 7 дней.
get_daily_summaryОбщая картина по дням: оценки сна, готовности и активности сразу.
get_heart_healthСосудистый возраст и VO2max. Обновляются редко, поэтому по умолчанию отдаются последние 30 дней.
get_heartrateПоминутный пульс, свёрнутый посуточно (среднее, минимум, максимум). По умолчанию — последние 3 дня.
get_readinessГотовность (readiness): оценка, баланс HRV, отклонение температуры. По умолчанию — последние 7 дней.
get_sleepДетальный сон: стадии, эффективность, HRV, пульс покоя, дыхание, отклонение температуры тела. Здесь же лежат ночные HRV и lowest_hr. По умолчанию — последние 7 дней.
get_sleep_scoreТолько дневная оценка сна и её вклады. Легче, чем get_sleep. По умолчанию — последние 7 дней.
get_spo2Насыщение крови кислородом во сне и индекс нарушений дыхания. По умолчанию — последние 7 дней.
get_statusРежим работы сервера и состояние авторизации. Полезно при отладке.
get_stressДневной стресс: время под нагрузкой и в восстановлении, оценка дня. По умолчанию — последние 7 дней.
get_tagsОтметки, проставленные вручную в приложении Oura. По умолчанию — последние 30 дней.
Public scan report
scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it
- Code scan23 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 61 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Oura Ring compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,243 servers
- Tools
- 11
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 35
- more than 24% of 12,306 servers with a package
What its tools let an agent do: 11 read
Install Oura Ring in Claude Code, Cursor or VS Code
claude mcp add oura-mcp -- uvx my-oura-mcp
What the publisher says
From the Oura Ring repository's README, as published. We do not edit it. Read it on GitHub
my-oura-mcp
Gives Claude, ChatGPT, and Codex access to your Oura Ring data: sleep, readiness, HRV, resting heart rate, activity, SpO₂, stress.
Ask "how did I sleep last week" and your MCP client calls the right tool and gets a summary back — not a wall of JSON:
{
"metric": "sleep_detail",
"period": { "start": "2026-07-23", "end": "2026-07-29", "days": 7 },
"stats": {
"total_h": { "mean": 7.1, "min": 5.9, "max": 8.4 },
"deep_h": { "mean": 1.3, "min": 0.9, "max": 1.8 },
"avg_hrv": { "mean": 42, "min": 31, "max": 55, "trend_per_week": 1.8 },
"efficiency": { "mean": 88, "min": 82, "max": 93 }
}
}New to MCP? Model Context Protocol lets AI clients reach external data.
Install this server, connect it once, then ask about your sleep in plain
language. No coding involved.
Works locally in Claude Code and Codex, and remotely in claude.ai and ChatGPT once it is deployed to a server of your own.
Читать по-русски: README.ru.md
Why another one
trend, not the raw API payload. Raw responses stay one raw=True away. A month of heart-rate data shrinks by more than 10×.
- Compact by default. Tools return per-day values plus statistics with a
for remote. A flag apart, not a rewrite.
- One codebase, two transports. stdio for local use, streamable-http
timestamp while returning a local day field, and returns heart-rate timestamps in UTC. Both quietly lose or misplace data outside UTC. This server handles it — see Timezone handling.
- Timezone-correct. Oura filters some endpoints by an internal UTC
dropped connections with exponential backoff, and turns HTTP status codes into messages that say what to fix.
- Survives flaky networks. Follows next_token pagination, retries
- Try before authorizing. Oura's sandbox works with no credentials at all.
Quick start
Requires uv. No Oura token needed for this part.
git clone https://github.com/AntVsl/oura_mcp && cd oura_mcp
cp .env.example .env
uv syncCheck that data flows (hits Oura's sandbox, no auth required):
uv run python -m my_oura_mcp.smokeConnect it locally — the server prints the commands with the absolute path already filled in, and writes nothing itself:
uv run my-oura-mcp installThen ask your client for an Oura summary. The get_status tool reports which mode the server is in.
Tools
Every data tool takes either daysback or an explicit startdate/end_date pair (YYYY-MM-DD), plus raw to get Oura's untouched response.
Using your own data
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Oura Ring: common questions
- Is Oura Ring MCP server safe?
- Mostly: it is graded B (78/100). Read the Oura Ring safety report
- How do I install Oura Ring?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Oura Ring need an API key?
- Yes. The registry entry asks for
OURA_CLIENT_SECRET,OURA_MCP_TOKEN. - Is Oura Ring maintained?
- The last commit was 67 days ago (2026-08-30). The latest release is v0.4.2.
- How does Oura Ring compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,243 servers); tools 11 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.