Claude MarketplacesSubmit
davidmosiah avatar

Ouramcp

davidmosiah/oura-mcp

A privacy-first connector that wires Oura Ring data into Claude and other MCP clients without sending tokens anywhere. It handles OAuth locally, then exposes daily readiness scores, sleep stages, HRV balance, activity summaries, heart rate streams, and SpO2 readings through a handful of focused tools. The demo mode returns synthetic payloads so you can prototype agent prompts before connecting real hardware. Setup is three commands: paste your Oura app credentials, complete the OAuth flow in a browser, verify with the doctor script. Useful when you want an AI agent to reason about recovery windows or sleep debt from live biometric signals instead of manual data entry.

tools
40
auth
Secret needed
transport
STDIO
env vars
8
last updated
May 29, 2026
View on GitHub

Tools

40 tools

Public tool metadata for what this MCP can expose to an agent.

personal_info.listSingle Personal Info Document

Single Personal Info Document

No parameter schema in public metadata yet.

tag.listMultiple Tag Documents3 params

Multiple Tag Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
enhanced_tag.listMultiple Enhanced Tag Documents3 params

Multiple Enhanced Tag Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
workout.listMultiple Workout Documents3 params

Multiple Workout Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
session.listMultiple Session Documents3 params

Multiple Session Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
daily_activity.listMultiple Daily Activity Documents3 params

Multiple Daily Activity Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
daily_sleep.listMultiple Daily Sleep Documents3 params

Multiple Daily Sleep Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
daily_spo2.listMultiple Daily Spo2 Documents3 params

Multiple Daily Spo2 Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
daily_readiness.listMultiple Daily Readiness Documents3 params

Multiple Daily Readiness Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
sleep.listMultiple Sleep Documents3 params

Multiple Sleep Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
sleep_time.listMultiple Sleep Time Documents3 params

Multiple Sleep Time Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
rest_mode_period.listMultiple Rest Mode Period Documents3 params

Multiple Rest Mode Period Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
ring_configuration.listMultiple Ring Configuration Documents1 params

Multiple Ring Configuration Documents

Parameters* required
next_tokenvalue
daily_stress.listMultiple Daily Stress Documents3 params

Multiple Daily Stress Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
daily_resilience.listMultiple Daily Resilience Documents3 params

Multiple Daily Resilience Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
daily_cardiovascular_age.listMultiple Daily Cardiovascular Age Documents3 params

Multiple Daily Cardiovascular Age Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
v_o2_max.listMultiple Vo2 Max Documents3 params

Multiple Vo2 Max Documents

Parameters* required
end_datevalue
next_tokenvalue
start_datevalue
tag.getSingle Tag Document1 params

Single Tag Document

Parameters* required
document_idstring
enhanced_tag.getSingle Enhanced Tag Document1 params

Single Enhanced Tag Document

Parameters* required
document_idstring
workout.getSingle Workout Document1 params

Single Workout Document

Parameters* required
document_idstring
session.getSingle Session Document1 params

Single Session Document

Parameters* required
document_idstring
daily_activity.getSingle Daily Activity Document1 params

Single Daily Activity Document

Parameters* required
document_idstring
daily_sleep.getSingle Daily Sleep Document1 params

Single Daily Sleep Document

Parameters* required
document_idstring
daily_spo2.getSingle Daily Spo2 Document1 params

Single Daily Spo2 Document

Parameters* required
document_idstring
daily_readiness.getSingle Daily Readiness Document1 params

Single Daily Readiness Document

Parameters* required
document_idstring
sleep.getSingle Sleep Document1 params

Single Sleep Document

Parameters* required
document_idstring
sleep_time.getSingle Sleep Time Document1 params

Single Sleep Time Document

Parameters* required
document_idstring
rest_mode_period.getSingle Rest Mode Period Document1 params

Single Rest Mode Period Document

Parameters* required
document_idstring
ring_configuration.getSingle Ring Configuration Document1 params

Single Ring Configuration Document

Parameters* required
document_idstring
daily_stress.getSingle Daily Stress Document1 params

Single Daily Stress Document

Parameters* required
document_idstring
daily_resilience.getSingle Daily Resilience Document1 params

Single Daily Resilience Document

Parameters* required
document_idstring
daily_cardiovascular_age.getSingle Daily Cardiovascular Age Document1 params

Single Daily Cardiovascular Age Document

Parameters* required
document_idstring
v_o2_max.getSingle Vo2 Max Document1 params

Single Vo2 Max Document

Parameters* required
document_idstring
webhook.subscription.listList Webhook Subscriptions

List Webhook Subscriptions

No parameter schema in public metadata yet.

webhook.subscription.createCreate Webhook Subscription4 params

Create Webhook Subscription

Parameters* required
callback_urlstring
data_typestring
one of tag · enhanced_tag · workout · session · sleep · daily_sleep
event_typestring
one of create · update · delete
verification_tokenstring
webhook.subscription.getGet Webhook Subscription1 params

Get Webhook Subscription

Parameters* required
idstring
webhook.subscription.updateUpdate Webhook Subscription5 params

Update Webhook Subscription

Parameters* required
callback_urlvalue
data_typevalue
event_typevalue
idstring
verification_tokenstring
webhook.subscription.deleteDelete Webhook Subscription1 params

Delete Webhook Subscription

Parameters* required
idstring
webhook.subscription.renew.updateRenew Webhook Subscription1 params

Renew Webhook Subscription

Parameters* required
idstring
heartrate.listMultiple Heart Rate Documents3 params

Multiple Heart Rate Documents

Parameters* required
end_datetimevalue
next_tokenvalue
start_datetimevalue

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

OURA_CLIENT_ID

Oura OAuth client ID. Optional when configured with oura-mcp-server setup.

OURA_CLIENT_SECRETsecret

Oura OAuth client secret. Prefer oura-mcp-server setup so this secret is stored in ~/.oura-mcp/config.json instead of MCP client config.

OURA_REDIRECT_URI

Redirect URI configured in the Oura Developer Dashboard. Optional when configured with oura-mcp-server setup.

OURA_TOKEN_PATH

Optional local path for OAuth tokens. Defaults to ~/.oura-mcp/tokens.json.

OURA_PRIVACY_MODE

Optional payload mode: summary, structured, or raw. Defaults to structured. raw means full Oura API payloads, not continuous 24/7 raw sensor telemetry.

OURA_CACHE

Optional SQLite cache toggle. Set to true or sqlite to enable.

OURA_CACHE_PATH

Optional local SQLite cache path. Defaults to ~/.oura-mcp/cache.sqlite.

OURA_NO_CACHE

Set to true to bypass the in-memory HTTP response cache (60s TTL for GET only). POST/PUT/DELETE and 4xx/5xx responses are never cached regardless.

Readme

Upgrading to 0.8.0: read the migration guide for local-only HTTP, disabled authenticated-response caching, and stricter input/profile limits.

Oura MCP

Oura MCP — Oura MCP for AI agents

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.

View the full README on GitHub

Details

Repository
github.com/davidmosiah/oura-mcp
Website
wellness.delx.ai/connectors/oura
Package
oura-mcp-unofficial
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from davidmosiah