From oura-mcp
Reference and recipes for Oura Ring API v2 via oura-mcp. Use when user asks about sleep, activity, readiness, heart rate, workouts, or other Oura data.
How this skill is triggered — by the user, by Claude, or both
Slash command
/oura-mcp:oura-api-skillThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill documents how to use `oura-mcp` (a Model Context Protocol server for Oura Ring API v2).
recipes/event-prep.mdrecipes/intervention-experiment.mdrecipes/monthly-narrative.mdrecipes/personal-best-discovery.mdrecipes/recovery-check.mdrecipes/recovery-debt-tracker.mdrecipes/sleep-trend.mdrecipes/symptom-investigator.mdrecipes/weekly-review.mdreferences/daily-activity.mdreferences/daily-cardiovascular-age.mdreferences/daily-readiness.mdreferences/daily-resilience.mdreferences/daily-sleep.mdreferences/daily-spo2.mdreferences/daily-stress.mdreferences/enhanced-tag.mdreferences/heartrate.mdreferences/personal-info.mdreferences/rest-mode-period.mdThis skill documents how to use oura-mcp (a Model Context Protocol server for Oura Ring API v2).
Run npx @yasuakiomokawa/oura-mcp configure once to set up OAuth credentials. After that, MCP clients (Claude Desktop, Claude Code, Cursor) can call the tools below.
oura_authenticate — re-authenticate via browser (after refresh_token expiry).oura_auth_status — check token state.oura_clear_auth — wipe stored tokens.oura_api_get — generic GET, e.g. path: "/v2/usercollection/daily_sleep". Use max_pages for large time-series.oura_api_list_paths — see all available endpoints./daily_*): start_date / end_date in YYYY-MM-DD. Default to last 7 days when user is vague.heartrate): start_datetime / end_datetime in ISO 8601 UTC, e.g. 2026-05-01T00:00:00Z.personal-info or ask.Most endpoints return { data: [...], next_token: "..." | null }. By default oura_api_get fetches one page. Pass max_pages: N (1-20) for auto-follow, or pass params: { next_token: "..." } manually.
daily-sleep, daily-activity, daily-readiness, daily-stress, daily-spo2, daily-resilience, daily-cardiovascular-agesleep, sleep-time, heartrate, workout, session, vo2-maxpersonal-info, ring-configuration, rest-mode-period, enhanced-tagSee references/ for per-endpoint detail and recipes/ for common workflows.
Each recipe is a workflow guide for a specific user intent, not a hard-coded function. Pick the one that matches the user's real question.
When a question fits multiple recipes (e.g., topic + timeframe), topic-specific wins. "先週の睡眠" is sleep-specific (sleep-trend), not a general weekly review (weekly-review). "先月の活動" is activity-specific, not monthly-narrative.
recipes/weekly-review.md — broad 7-day review across sleep / activity / readiness. Use when user asks generally about "last week".recipes/sleep-trend.md — sleep-only deep dive (stages, efficiency, trend). Use when the question is sleep-specific, not weekly-review.recipes/recovery-check.md — point-in-time "am I recovered right now?". Today only, not a trend.recipes/monthly-narrative.md — narrative monthly retrospective + next-month theme. Use for month-scale reflection, not week-scale.recipes/symptom-investigator.md — vague complaint ("最近疲れる") → hypothesis-driven multi-endpoint checkrecipes/recovery-debt-tracker.md — quantify accumulated load and project recovery timerecipes/event-prep.md — maximize tomorrow's readiness for an important eventrecipes/intervention-experiment.md — design and run a 2-week A/B self-experimentrecipes/personal-best-discovery.md — mine your own best days for a personalized this-week checklistoura_authenticate (in chat) or npx @yasuakiomokawa/oura-mcp configure (in terminal).oura_api_list_paths.The diagnostic and discovery recipes draw inspiration from analytical tools in mitchhankins01/oura-ring-mcp (MIT, separate implementation). The recipes here are reframed as LLM workflow guides rather than fixed functions, and are written from scratch.
Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
npx claudepluginhub yasuakiomokawa/oura-mcp --plugin oura-mcp