---
title: Oura Ring MCP connector
description: Daily readiness, sleep periods, HRV trend and SpO2.
canonical: https://wellness.delx.ai/connectors/oura
content_signal: ai-train=no, search=yes, ai-input=yes
---

# Oura Ring MCP Connector

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

## Install

```bash
npx -y oura-mcp-unofficial setup
npx -y oura-mcp-unofficial doctor
```

## Agent client config

```json
{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["-y", "oura-mcp-unofficial"]
    }
  }
}
```

## Signals

- Readiness
- Sleep
- Activity
- HRV
- SpO2

## Data availability

- Daily readiness score and contributors: available. Requires daily scope.
- Daily sleep score and sleep periods: available. Requires daily and/or sleep scope.
- Sleep stages and timing: available. Available when Oura returns scored sleep.
- Daily activity, steps, calories and MET: available. Requires daily scope.
- Heart-rate time series: conditional. Depends on ring, membership and granted scope.
- HRV and SpO2: available. HRV is surfaced through readiness; SpO2 requires spo2 scope and supported devices.
- Continuous sensor telemetry: not_available. Not exposed by the Oura Cloud API.

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

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

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

## Best for

- Sleep-led daily planning
- Readiness trend review
- Activity balance coaching
- Heart-rate context investigation

## Known limits

- No continuous raw sensor telemetry.
- Availability depends on Oura device, membership and scopes.

## Links

- GitHub: https://github.com/davidmosiah/ouramcp
- npm: https://www.npmjs.com/package/oura-mcp-unofficial
- Legacy docs: https://ouramcp.vercel.app/
- Provider docs: https://cloud.ouraring.com/docs/authentication