# Oura Ring

> Oura Ring is an open-source MCP server for health and science. Read-only Oura Ring sleep, readiness, activity and heart rate data for AI clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://oura-ring-python-mcp.readthedocs.io
- **Repository:** https://github.com/osjayaprakash/oura-ring-python-mcp
- **MCP Registry name:** io.github.osjayaprakash/oura-ring-python-mcp
- **Categories:** health and science
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/oura-ring-2
