
Ouraclaw
- 687 installs
- 2 repo stars
- Updated July 14, 2026
- montagao/skills
ouraclaw is a Claude Code skill that fetches Oura Ring sleep and activity metrics through the ouraclaw CLI as JSON for developers who embed wearable health data into agent workflows, coaching prompts, and daily summaries
About
ouraclaw is an agent integration skill that pulls Oura Ring sleep and activity data via the montagao ouraclaw CLI and returns JSON to stdout for downstream agent use. It triggers on sleep score, HRV, sleep stages, heart rate during sleep, bedtimes, and general Oura metric requests. Setup verifies ouraclaw with which, then clones the GitHub repo, runs bun install, and bun link if missing. Authenticated fetches supply structured JSON for personalized health insights, coaching prompts, and automated daily summaries inside Claude Code or compatible agents. Use ouraclaw when building health-aware agent workflows that need last-night sleep quality, HRV trends, or activity context without writing Oura API clients from scratch.
- Oura API
- sleep metrics
- activity sync
- agent context
Ouraclaw by the numbers
- 687 all-time installs (skills.sh)
- +3 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #1,440 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/montagao/skills --skill ouraclawAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 687 |
|---|---|
| repo stars | ★ 2 |
| Last updated | July 14, 2026 |
| Repository | montagao/skills ↗ |
How do you pull Oura Ring sleep data into agent workflows?
Connect Oura wearable sleep and activity data into agent workflows for personalized health insights, coaching prompts, and automated daily summaries.
Who is it for?
Developers building health-aware agent automations who already use Oura Ring and want CLI-fetched JSON without custom API integration code.
Skip if: Engineers without Oura Ring hardware or teams needing full Oura API webhook pipelines instead of CLI-based agent fetches.
When should I use this skill?
A user asks about sleep score, last night's sleep, HRV, Oura data, sleep quality, or bedtimes and agent workflows need structured wearable metrics.
What you get
JSON stdout with Oura sleep scores, HRV, sleep stages, heart rate, and bedtime metrics
- Oura metrics JSON
- sleep and activity summaries for agents
Files
Ouraclaw
Fetch Oura Ring sleep data via the ouraclaw CLI. Outputs JSON to stdout.
Ensure ouraclaw is installed
which ouraclawIf not found:
git clone https://github.com/montagao/ouraclaw.git ~/projects/ouraclaw
cd ~/projects/ouraclaw && bun install && bun linkIf 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-15Extracting 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.
Related skills
FAQ
How does ouraclaw return Oura Ring data to agents?
ouraclaw runs the ouraclaw CLI, which fetches Oura Ring sleep and activity metrics and prints structured JSON to stdout. Agent workflows consume that JSON for sleep scores, HRV, stages, heart rate, and bedtime summaries.
How do you install the ouraclaw CLI?
ouraclaw checks which ouraclaw, then clones github.com/montagao/ouraclaw, runs bun install, and bun link if the binary is missing. Authentication may be required before fetches succeed.