oura — Claude Code skill: Oura Ring data in your chat
Hooks the Oura Ring API into your agent so you can ask about sleep, readiness, activity and stress. Handy if you wear the ring and work in a terminal.
npx skills add jjenkins/agent-oura --skill oura -a claude-codeWhat oura does
This skill turns the agent into an assistant for Oura Ring data. It talks to the Oura API and returns sleep, readiness, activity, stress, SpO2, heart rate and workouts. The scripts are Node: setup.mjs handles credentials, auth.mjs runs OAuth2, dashboard.mjs prints today's summary, profile.mjs covers account and ring details, and query.mjs pulls a date range or correlates two endpoints.
You need a client_id and client_secret from an Oura application before anything works. Register one at cloud.ouraring.com/oauth/applications with redirect URI http://localhost:8910/callback. Then /oura setup writes the keys to ~/.oura/config.json, and /oura auth opens the browser and catches the code on localhost:8910/callback; tokens land in ~/.oura/tokens.json. Skip that step and every data command fails, because the status check comes back with "authenticated": false.
The Oura API only serves roughly 60 days of history. Ask for more and the script caps the start date at 60 days and says so. Today-only questions go through the dashboard; anything spanning several days goes to query.mjs with an endpoint name and a date range.
What it helps with
- see today's sleep and readiness scores
- compare sleep against activity over a week
- check how a workout hit recovery
- pull heart rate and SpO2 for a date range
- read ring and account details
Example prompts for the agent
- Show my Oura dashboard for today
- How did I sleep over the last 7 days?
- Does my sleep correlate with readiness this month?
How to install oura
1Skills CLI (Vercel)
npx skills add jjenkins/agent-oura --skill oura -a claude-code2Manually: put the files in place
~/.claude/skills/oura/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/oura/
1Skills CLI (Vercel)
npx skills add jjenkins/agent-oura --skill oura -a codex2Manually: put the files in place
.agents/skills/oura/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jjenkins/agent-oura --skill oura -a cursor2Manually: put the files in place
.cursor/skills/oura/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jjenkins/agent-oura oura2Manually: put the files in place
.github/skills/oura/SKILL.md1Skills CLI (Vercel)
npx skills add jjenkins/agent-oura --skill oura -a gemini-cli2Platform CLI
gemini skills install https://github.com/jjenkins/agent-oura --path .claude/skills/ouraManually: put the files in place
.devin/skills/oura/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jjenkins/agent-oura --skill oura -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about oura
How do I install oura in Claude Code?
Run npx skills add jjenkins/agent-oura --skill oura -a claude-code. The skill lands at ~/.claude/skills/oura/SKILL.md.
What does the oura skill do?
It connects to the Oura API and shows sleep, readiness, activity, stress, SpO2, heart rate and workouts. You get a daily dashboard plus queries over a date range.
What do I need before using it?
A client_id and client_secret from an Oura application, plus a completed OAuth2 flow. Keys go to ~/.oura/config.json and tokens to ~/.oura/tokens.json.
