Profile My skills Saved Collections Edit profile Submit a skill

Ouraclaw

Fetch Oura Ring sleep data using the ouraclaw CLI. Use when the user asks about their sleep score, sleep data, sleep stages, HRV, heart rate during sleep, bedtimes, or any Oura Ring data. Triggers on "sleep score", "how did I sleep", "oura data", "sleep data", "last night's sleep", "sleep quality", "HRV", or any request for Oura Ring metrics.

montagao 866fcdd 1.4 KB Updated
Coding & Dev Tools

File contents

Ouraclaw

Fetch Oura Ring sleep data via the ouraclaw CLI. Outputs JSON to stdout.

Ensure ouraclaw is installed

which ouraclaw

If not found:

git clone https://github.com/montagao/ouraclaw.git ~/projects/ouraclaw
cd ~/projects/ouraclaw && bun install && bun link

If auth is needed (no tokens in .env), run cd ~/projects/ouraclaw && ouraclaw auth.

Commands

# Last night's sleep score
ouraclaw score

# Date range
ouraclaw score --start 2025-02-01 --end 2025-02-15

# Detailed sleep sessions (stages, HR, HRV, bedtimes)
ouraclaw sleep

# Date range
ouraclaw sleep --start 2025-02-01 --end 2025-02-15

Extracting fields with jq

ouraclaw score | jq '.data[0].score'
ouraclaw sleep | jq '.data[0] | {bedtime_start, bedtime_end}'
ouraclaw score --start 2025-02-01 --end 2025-02-15 | jq '[.data[] | {day, score}]'

Error handling

  • "No access token": Run cd ~/projects/ouraclaw && ouraclaw auth.
  • 401 after auto-refresh fails: Re-run ouraclaw auth.

montagao/skills/tree/main/ouraclaw commit 866fcdd4b3

Browse category

Frequently asked questions

npx skillmds add montagao/ouraclaw