Delx Wellness
All connectors
Oura

oura-mcp-unofficial

Oura Ring

A privacy-aware Oura connector for agents that need sleep, recovery and daily activity signals from the Oura Cloud API.

ReadinessSleepActivityHRVSpO2
Install from npmRepository
A recovery space with mobility work and calm wellness analytics
OAuth 2.0

Best for sleep-first wellness agents, habit coaches and daily planning assistants that need readiness and overnight recovery context.

Quick Start

terminal
npx -y oura-mcp-unofficial setup
npx -y oura-mcp-unofficial doctor
mcp-client.json
{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["-y", "oura-mcp-unofficial"]
    }
  }
}
  1. 01

    Create an Oura OAuth app.

  2. 02

    Use redirect URI http://127.0.0.1:3000/callback.

  3. 03

    Request the scopes that match the data your agent needs.

Recommended scopes

daily heartrate personal sleep workout spo2

Data Availability

Available

Daily readiness score and contributors

Requires daily scope.

Available

Daily sleep score and sleep periods

Requires daily and/or sleep scope.

Available

Sleep stages and timing

Available when Oura returns scored sleep.

Available

Daily activity, steps, calories and MET

Requires daily scope.

Conditional

Heart-rate time series

Depends on ring, membership and granted scope.

Available

HRV and SpO2

HRV is surfaced through readiness; SpO2 requires spo2 scope and supported devices.

Not exposed

Continuous sensor telemetry

Not exposed by the Oura Cloud API.

Agent Tools

Start here

  • oura_connection_status
  • oura_daily_summary
  • oura_weekly_summary

Auth and diagnostics

  • oura_capabilities
  • oura_agent_manifest
  • oura_privacy_audit
  • oura_cache_status
  • oura_get_auth_url
  • oura_exchange_code
  • oura_revoke_access

Profile

  • oura_get_personal_info

Daily collections

  • oura_list_daily_readiness
  • oura_list_daily_sleep
  • oura_list_daily_activity
  • oura_list_daily_spo2

Detailed collections

  • oura_list_sleep
  • oura_list_workouts
  • oura_list_heartrate
  • oura_list_sessions
  • oura_list_tags

Prompts and Resources

Prompts

  • oura_daily_checkin
  • oura_weekly_review
  • oura_heart_context_investigation

Resources

  • oura://capabilities
  • oura://agent-manifest
  • oura://personal-info
  • oura://latest/readiness
  • oura://summary/daily
  • oura://summary/weekly

Privacy Model

OAuth tokens stay local.
The connector is scoped to the permissions the user grants.
Agent-facing summaries can avoid sensitive raw payloads.
Raw means upstream Oura API JSON, not raw ring sensor streams.