ouraRetrieve and summarize health, sleep, activity, readiness, and biometric data from the Oura Ring API via a command-line interface.
Install via ClawdBot CLI:
clawdbot install ruhrpotter/ouraThis tool allows retrieving health and biometric data from the Oura Ring API (V2) via a command-line interface. Use this to answer questions about the user's sleep, activity, readiness, and physiological stats.
Repository: https://github.com/ruhrpotter/oura-cli
cd ~
git clone https://github.com/ruhrpotter/oura-cli.git
cd oura-cli
go build -o oura ./cmd/ourahttp://localhost:8080/callbackexport OURA_CLIENT_ID="your_client_id"
export OURA_CLIENT_SECRET="your_client_secret"
./oura auth loginA browser will open for OAuth authorization. Tokens are stored in ~/.config/oura-cli/config.json.
The CLI must be authenticated. If a command fails with an auth error, notify the user to run ./oura auth login.
./oura get
personal: User profile (age, weight, height, email).sleep: Daily sleep scores and efficiency.activity: Daily activity scores, steps, and movement.readiness: Daily readiness scores indicating recovery.heartrate: Time-series heart rate data.workout: Detailed workout sessions.spo2: Blood oxygen saturation levels.sleep-details: Detailed sleep sessions including hypnograms.sessions: Activity sessions (e.g. naps, rest).sleep-times: Optimal bedtime guidance.stress: Daily stress levels.resilience: Daily resilience scores and recovery.cv-age: Cardiovascular age estimates.vo2-max: VO2 Max measurements.ring-config: Ring hardware configuration (color, size, etc.).rest-mode: Rest mode periods.tags: Enhanced tags (notes, lifestyle choices).--start : REQUIRED for most time-series data. The start date of the range.--end : OPTIONAL. The end date of the range. If omitted, it may default to the start date or return a single day depending on context.YYYY-MM-DD string format based on the current operational date.--start to today's date.--start to yesterday's date.--start to 7 days ago and --end to today../oura in the current working directory unless the user specifies otherwise.data array to formulate a natural language response.User Request: "How was my sleep last night?"
Context: Today is 2024-03-15. "Last night" usually implies the sleep session ending on the morning of today, or the previous day's data depending on how Oura dates it (Oura dates sleep by the morning it ends).
Reasoning: Sleep for the night of the 14th to 15th is logged as 2024-03-15.
Command:
./oura get sleep --start 2024-03-15User Request: "What is my readiness score today?"
Context: Today is 2024-03-15.
Command:
./oura get readiness --start 2024-03-15User Request: "Show my heart rate for the first week of January 2024."
Command:
./oura get heartrate --start 2024-01-01 --end 2024-01-07User Request: "Who am I?"
Command:
./oura get personalGenerated Mar 1, 2026
Individuals use the skill to track daily biometrics like sleep, readiness, and activity scores from their Oura Ring. It helps users monitor trends, adjust lifestyle habits, and improve overall wellness through data-driven insights.
Companies integrate this skill into employee wellness initiatives to aggregate anonymized data on sleep and stress levels. It enables HR teams to assess program effectiveness, offer personalized recommendations, and boost workforce productivity and well-being.
Coaches and athletes leverage the skill to analyze readiness scores, heart rate variability, and VO2 Max data. This supports tailored training schedules, recovery monitoring, and performance enhancement for professional or amateur sports teams.
Researchers use the skill to collect longitudinal health data from study participants via Oura Rings. It facilitates analysis of sleep patterns, stress, and physiological metrics for studies on chronic conditions or treatment outcomes.
Health coaches incorporate the skill to access clients' Oura data, providing personalized feedback on sleep quality, activity levels, and recovery. This enhances coaching sessions with objective metrics for goal-setting and progress tracking.
Offer a premium service where users pay a monthly fee for advanced insights, trend visualizations, and personalized health recommendations derived from Oura data. Revenue comes from tiered subscriptions with features like AI-driven reports and integration with other health apps.
License the skill to corporations for use in wellness programs, charging per employee or as a flat enterprise fee. Revenue is generated through licensing agreements that include data aggregation tools, dashboards, and compliance with privacy regulations.
Develop a mobile or web app that uses the skill for free basic data access, with premium features like detailed analytics, export capabilities, and coach access available for purchase. Revenue streams include one-time purchases for advanced features and in-app advertising.
💬 Integration Tip
Ensure authentication is set up via OAuth before running commands, and always resolve relative dates like 'today' to YYYY-MM-DD format for accurate data retrieval.
Plan, focus, and complete work with energy management, time blocking, and context-specific productivity systems.
Build habits with streaks, reminders, and progress visualization
Comprehensive AI-assisted therapeutic support framework with CBT, ACT, DBT, MI, session notes CLI, and crisis protocols.
iOS HealthKit data sync CLI commands and patterns. Use when working with healthsync CLI, fetching Apple Health data (steps, heart rate, sleep, workouts), pairing iOS devices over local network, or understanding the iOS Health Sync project architecture including mTLS certificate pinning, Keychain storage, and audit logging.
Load and analyze Strava activities, stats, and workouts using the Strava API
Talk to your Garmin data naturally - "what was my fastest speed snowboarding?", "how did I sleep last night?", "what was my heart rate at 3pm?". Access 20+ metrics (sleep stages, Body Battery, HRV, VO2 max, training readiness, body composition, SPO2), download FIT/GPX files for route analysis, query elevation/pace at any point, and generate interactive health dashboards. From casual "show me this week's workouts" to deep "analyze my recovery vs training load".