Skip to content
MCP server

Oura Ring

Read-only Oura Ring sleep, readiness, activity and heart rate data for AI clients

Runs locallyStatus and history
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-mcp

Add 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 applicationRequired
  • OURA_CLIENT_SECRETClient secret of your Oura API applicationRequired
  • OURA_TOKEN_FILEWhere `oura-ring-python-mcp auth` saved the OAuth tokens
  • OURA_TIMEZONEYour IANA time zone (e.g. Europe/London), so "today" is your day; defaults to the machine's
  • OURA_CLIENT_IDClient ID of your Oura API applicationRequired
  • OURA_CLIENT_SECRETClient secret of your Oura API applicationRequired
  • OURA_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

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science