mcpField
O
ouraclaw

ouraclaw

github.com/montagaoOther3692 installsUpdated 8w ago
Repository

About ouraclaw

ouraclaw is a CLI reference skill for retrieving Oura Ring sleep data as JSON. It helps users run score and sleep queries, including date-range requests, and process the output with jq.

Key features

  1. 01Fetch sleep scores
  2. 02Query detailed sleep sessions
  3. 03Filter results by date range
  4. 04Emit JSON to stdout
  5. 05Extract fields with jq

Use cases

  1. 01Check the previous night's sleep score
  2. 02Review sleep stages, heart rate, and HRV
  3. 03Compare sleep scores across a date range
  4. 04Extract selected sleep fields for analysis

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/montagao/skills --skill ouraclaw

After installing, type/ouraclawin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported