Ouramcp MCP server
Privacy-first, unofficial Oura MCP server for AI health, sleep, activity and heart-rate agents.
6 stars419 downloads/wk
Reviews
Write oneNobody has reviewed Ouramcp yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Ouramcp tools (18, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
oura_agent_manifestMachine-readable install, runtime and client guidance for AI agents. Does not call Oura or expose secrets.
oura_cache_statusShow optional local SQLite cache status. Enable with OURA_CACHE=sqlite or OURA_CACHE=true.
oura_capabilitiesExplain supported Oura data, privacy boundaries, recommended agent workflow and project links.
oura_connection_statusCheck local Oura config, token file, Node version, privacy mode, cache readiness and optional MCP client readiness without calling Oura or exposing secrets.
oura_daily_summaryBuild a practical daily summary from Oura readiness, sleep, activity, heart-rate and SpO2 data when available. Read-only and non-medical.
oura_data_inventoryInventory supported Oura data domains, auth scope requirements, privacy boundary and recommended first calls. Does not call Oura APIs or expose user data.
oura_demoReturns realistic example payloads of oura_daily_summary, oura_wellness_context, and oura_list_daily_readiness so agents see the contract before calling real Oura APIs.
oura_exchange_codeExchange an Oura OAuth authorization code for local tokens. Tokens are stored locally with 0600 permissions and are never returned.
oura_get_auth_urlGenerate an Oura OAuth authorization URL. Use this first when no local token exists.
oura_get_personal_infoGet Oura personal profile fields available to the authorized app. Requires the personal scope.
oura_onboardingReturn the 11-question Delx wellness onboarding flow (in English or pt-BR) plus the current shared profile state and missing critical fields. Read-only. The agent should ask these questions one-by-one, then call oura_profile_update with explicit_user_intent=true to save. The same profile is reused by every Delx Wellness connector (WHOOP, Garmin, Nourish, etc.) — agents can call the equivalent {con
oura_privacy_auditReturn local privacy, cache, token-path and env-presence posture without revealing secret values.
oura_profile_getRead the shared Delx wellness profile (~/.delx-wellness/profile.json). Returns the user's preferred name, body basics, goals, devices, training context, nutrition context, agent preferences, and missing critical fields. Cross-connector — the same profile is also available from other Delx Wellness MCPs (WHOOP, Garmin, Nourish, Fitbit, etc). Read-only.
oura_profile_updatewrite actionPersist a partial patch to the shared Delx wellness profile (~/.delx-wellness/profile.json). REQUIRES explicit_user_intent=true. Top-level fields stored: profile (preferred_name, language, timezone, units, age_or_birth_year, height, weight, sex_or_gender_context), goals, devices, training, nutrition, preferences, safety, notes. NEVER stores OAuth tokens, API keys, refresh tokens, cookies, or any s
oura_quickstartPersonalized 3-step setup walkthrough for the human user. Adapts to current state (env vars set? token present? what's next?). Call this first when the user asks 'how do I connect Oura?'
oura_revoke_accessRevoke the current Oura OAuth grant and delete the local token file. Use only when the user explicitly wants to disconnect Oura.
oura_weekly_summaryBuild a weekly Oura scorecard with readiness, sleep, activity, HRV availability, bottlenecks and actions. Read-only and non-medical.
oura_wellness_contextNormalize Oura readiness, sleep and activity load into the shared wellness_context shape for recommendation engines.
Public scan report
scanner v0.1.10 · 2026-11-10 · same rubric, same numbers if you re-run it
- Code scan58 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 5 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Ouramcp compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,114 servers
- Tools
- 18
- the typical server has 7
- Tools that change things
- 6%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 6
- more than 85% of 28,851 servers
- Downloads a week
- 419
- more than 86% of 15,093 servers with a package
What its tools let an agent do: 17 read · 1 change
Install Ouramcp in Claude Code, Cursor or VS Code
Runs npx -y oura-mcp-unofficial on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add ouramcp -- npx -y oura-mcp-unofficial
What the publisher says
From the Ouramcp repository's README, as published. We do not edit it. Read it on GitHub
<!-- delx-wellness header v2 --> Oura MCP
Give your AI agent your Oura readiness, sleep, activity and HRV — without copy-pasting from the Oura app. Local-first MCP server — tokens never leave your machine.
⚡ One-command install with Delx Wellness for Hermes:
npx -y delx-wellness-hermes setup — preconfigures this connector and the other 8 in a dedicated Hermes profile.
Or wire it standalone into Claude Desktop / Cursor / ChatGPT Desktop — see the install section below.
HTTP (v2 stateless)
Default is stdio. Optional Streamable HTTP — no session id, JSON responses, loopback only:
npx -y oura-mcp-unofficial --http
# GET http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp (sessionless)Env: OURAMCPHOST, OURAMCPPORT, OURAMCPTRANSPORT=http.
<!-- /delx-wellness header v2 -->
Local-first MCP server that connects AI agents to your Oura Ring readiness, sleep, activity and HRV data.
Unofficial project. Not affiliated with, endorsed by or supported by Ōura Health Oy. Oura is a trademark of its respective owner. Use this only with your own Oura account and in line with the Oura Cloud API terms.
Built by David Mosiah for people who use Claude, Cursor, Hermes, OpenClaw or other MCP-compatible agents to think about readiness, sleep and recovery — without copy-pasting numbers from the Oura app.
Part of Delx Wellness, a registry of local-first wellness MCP connectors.
If this connector helps your agent workflow, please star the repo. Stars make the project easier for other AI builders to discover and help Delx keep shipping local-first wellness infrastructure.
Why this exists
Oura Ring produces some of the most refined personal health signals — readiness scores, sleep stages, HRV, daily activity, SpO2, body temperature trends. But it lives behind an OAuth API with per-scope authorization, and the data is split across multiple endpoints (daily readiness vs. detailed sleep periods vs. heart-rate streams).
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Ouramcp: common questions
- Is Ouramcp MCP server safe?
- Mostly: it is graded B (83/100). Read the Ouramcp safety report
- How do I install Ouramcp?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Ouramcp need an API key?
- Yes. The registry entry asks for
OURA_CLIENT_SECRET. - Is Ouramcp maintained?
- The last commit was 10 days ago (2026-11-05). The latest release is v0.4.6.
- How does Ouramcp compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,114 servers); tools 18 (the typical server has 7); tools that change things 6% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.