oura-cliRetrieve health and biometric data from your Oura Ring via CLI commands for sleep, activity, readiness, heart rate, and more using specified dates.
Install via ClawdBot CLI:
clawdbot install Supadoopa/oura-cliThis 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
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 tracking daily biometrics like sleep, readiness, and activity to optimize workouts and recovery. They use the CLI to retrieve data for personal analysis, adjusting training intensity based on readiness scores and sleep efficiency to prevent overtraining.
Patients with conditions like sleep apnea or cardiovascular issues use the tool to monitor heart rate, SpO2, and stress levels over time. Healthcare providers can integrate the data into telehealth platforms for remote patient monitoring, aiding in early intervention and personalized treatment plans.
Companies implement wellness initiatives where employees share anonymized activity and resilience data to promote health. The CLI enables HR teams to aggregate trends, offering insights into workforce well-being and designing targeted interventions like stress management workshops.
Sports teams use the tool to monitor athletes' sleep details, VO2 max, and recovery metrics during training seasons. Coaches analyze the data to tailor rest periods and training loads, reducing injury risks and enhancing performance in competitive events.
Researchers collect biometric data from participants to study correlations between sleep patterns, activity levels, and health outcomes. The CLI facilitates data extraction for analysis in studies on public health, psychology, or behavioral science, supporting evidence-based conclusions.
Offer a premium service where users pay a monthly fee for advanced insights, trend visualizations, and personalized recommendations based on their Oura data. Revenue is generated through tiered subscriptions, with higher tiers including features like AI-driven health coaching or integration with other fitness apps.
License aggregated, anonymized biometric data to hospitals, clinics, or insurance companies for population health analysis. This helps in developing predictive models for disease prevention or optimizing wellness programs, with revenue coming from one-time or ongoing licensing agreements.
Provide the basic CLI for free to attract users, then monetize through paid add-ons such as automated reporting, API integrations with other health tools, or premium support. Revenue streams include one-time purchases for advanced features or consulting services for custom deployments.
💬 Integration Tip
Ensure authentication is handled via `./oura auth login` before running commands, and parse the JSON output's 'data' array to extract meaningful insights for user responses.
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.
Retrieve and summarize health, sleep, activity, readiness, and biometric data from the Oura Ring API via a command-line interface.
Load and analyze Strava activities, stats, and workouts using the Strava API