Oura Ring Skill

Query Oura Ring health data via the Oura API v2. Requires a personal access token at ~/.config/oura/credentials.json.

Setup

CODEBLOCK0

Get your token at https://cloud.ouraring.com/personal-access-tokens

Commands

All commands use: INLINECODE1

status

Connection test + personal info (age, email, biological sex).

briefing

Today's combined readiness + sleep + activity summary. Best for morning check-ins.

sleep [YYYY-MM-DD]

Detailed sleep data: duration, stages, efficiency, HRV, temperature. Defaults to last night.

readiness [YYYY-MM-DD]

Readiness score with all contributors (HRV balance, body temp, recovery, sleep, activity). Defaults to today.

activity [YYYY-MM-DD]

Activity details: steps, calories, active time, movement breakdown. Defaults to today.

heartrate [hours]

Recent heart rate statistics (min, max, avg, latest). Default: last 4 hours.

trends [days]

Multi-day trend view of readiness, sleep, and activity scores. Default: 7 days.

Health Alerts

Standalone alert checker for heartbeats/crons:

CODEBLOCK1

Outputs one line per alert. Empty output = nothing notable. Exit code 0 always.

Checks:

• - Readiness < 70
• Sleep < 6 hours
• HRV trending down 3+ days
• Resting HR spike > 5bpm above 7-day average
• Body temperature deviation > 0.5°C
• Recovery index < 30

Output Format

All output is human-readable text with emoji indicators:

• - 🟢 Good (score ≥ 85)
• 🟡 Fair (score 70–84)
• 🔴 Needs attention (score < 70)

Error Handling

• - Exit code 0: success
• Exit code 1: error (message on stderr)
• Common errors: missing credentials file, invalid token, no data for date