ouracliAccess Oura Ring health data using the ouracli CLI tool. Use when user asks about "oura data", "sleep stats", "activity data", "heart rate", "readiness score", "stress levels", or wants health metrics from their Oura Ring.
Install via ClawdBot CLI:
clawdbot install ouracliRetrieves health and fitness data from the Oura Ring using the ouracli command-line interface.
ALWAYS check for authentication before running ouracli commands. The tool requires a PERSONAL_ACCESS_TOKEN environment variable.
secrets/oura.env or ~/.secrets/oura.envactivity - Daily activity (steps, MET values, calories)sleep - Sleep data (stages, efficiency, heart rate)readiness - Readiness scores and contributorsheartrate - Time-series heart rate data (5-minute resolution)spo2 - Blood oxygen saturation datastress - Daily stress levelsworkout - Workout sessionssession - Activity sessionstag - User-added tagsrest-mode - Rest mode periodspersonal-info - User profile informationall - All available data types# Single date (no quotes needed)
ouracli activity 2025-12-25
ouracli sleep today
ouracli heartrate yesterday
# Relative ranges from today (MUST use quotes)
ouracli activity "7 days" # Last 7 days including today
ouracli sleep "30 days" # Last 30 days
ouracli readiness "2 weeks" # Last 2 weeks
ouracli stress "1 month" # Last month
# Date + duration (MUST use quotes)
ouracli activity "2025-12-01 28 days" # 28 days starting Dec 1
ouracli sleep "2025-09-23 7 days" # Week starting Sept 23ā ļø CRITICAL: Use quotes when the date range contains spaces!
# ā WRONG - Two separate dates
ouracli activity 2025-09-23 2025-09-30
# ā WRONG - "to" syntax
ouracli activity "2025-09-23 to 2025-09-30"
# ā WRONG - Range operators
ouracli activity "2025-09-23..2025-09-30"
# ā WRONG - Relative past expressions
ouracli activity "3 months ago"If user requests data between two specific dates:
Step 1: Calculate the number of days (inclusive)
Example: Sept 23 to Sept 30 = 7 days
Dec 1 to Dec 31 = 30 daysStep 2: Use the "date + duration" format
# ā
CORRECT
ouracli activity "2025-09-23 7 days"
ouracli activity "2025-12-01 30 days"ALWAYS use --json for programmatic data analysis. This is the most reliable format for parsing.
# ā
RECOMMENDED for AI analysis
ouracli activity "7 days" --json
# Other formats (human-readable)
ouracli activity today --tree # Default: tree structure
ouracli activity "7 days" --markdown # Markdown with charts
ouracli activity "7 days" --html > activity.html # Interactive HTML charts
ouracli activity "7 days" --dataframe # Pandas DataFrame format# Today's activity
ouracli activity today --json
# Recent sleep data
ouracli sleep "7 days" --json
# Current readiness
ouracli readiness today --json# Weekly health summary
ouracli all "7 days" --json
# Monthly activity report
ouracli activity "30 days" --json
# Heart rate for specific date
ouracli heartrate "2025-12-15 1 days" --json# All data grouped by day (HTML report)
ouracli all "7 days" --by-day --html > weekly-report.html
# All data grouped by type
ouracli all "7 days" --by-method --jsonā ļø IMPORTANT: The contributors.resting_heart_rate field in readiness data is a SCORE (0-100), NOT actual BPM:
heartrate command outputDO NOT interpret contributor scores as actual heart rate measurements.
Cause: Used two separate date arguments instead of one quoted range
# ā WRONG
ouracli activity 2025-09-23 2025-09-30
# ā
CORRECT
ouracli activity "2025-09-23 7 days"Cause: Used unsupported syntax like "to", "..", or relative expressions
# ā WRONG
ouracli activity "2025-09-23 to 2025-09-30"
# ā
CORRECT
ouracli activity "2025-09-23 7 days"Solutions:
ouracli activity "7 days" --jsonouracli activity "2025-12-25 2 days" --jsonouracli activity "7 days" --jsonouracli sleep today --jsonouracli readiness "2025-12-01 30 days" --json# Calculate: Sept 30 - Sept 23 = 7 days
ouracli all "2025-09-23 7 days" --jsonouracli heartrate yesterday --json| User Intent | Command |
|-------------|---------|
| Today's activity | ouracli activity today --json |
| Last week's sleep | ouracli sleep "7 days" --json |
| Current readiness | ouracli readiness today --json |
| Heart rate today | ouracli heartrate today --json |
| Monthly summary | ouracli all "30 days" --json |
| Specific date range | ouracli [TYPE] "YYYY-MM-DD N days" --json |
| All data types | ouracli all "7 days" --json |
--json format for AI analysisGenerated Feb 24, 2026
Remote employees use the skill to track daily activity, sleep, and readiness scores, integrating data into wellness dashboards to optimize work-life balance and productivity. Managers can aggregate anonymized team metrics to identify burnout trends and promote healthier routines.
Coaches and athletes leverage the skill to analyze sleep quality, heart rate variability, and stress levels from Oura Ring data to tailor training schedules and recovery plans. This helps prevent overtraining and enhances performance during competitions.
Healthcare providers use the skill to monitor patients' daily health metrics like heart rate and blood oxygen saturation, enabling remote tracking of conditions such as sleep apnea or cardiovascular issues. Data is integrated into electronic health records for proactive care.
Developers embed the skill into mobile apps to provide users with personalized insights from Oura Ring data, such as sleep patterns and activity trends. This enhances user engagement by offering data-driven recommendations for lifestyle improvements.
Researchers utilize the skill to gather longitudinal health data from study participants, automating the extraction of metrics like stress levels and readiness scores for analysis. This streamlines data collection in fields like psychology or public health.
Offer a paid platform that integrates Oura Ring data with personalized coaching and analytics, charging users a monthly fee for advanced insights and health recommendations. Revenue is generated through tiered subscription plans based on feature access.
Sell the skill as part of a corporate wellness package to companies, providing aggregated team health reports and tools to reduce healthcare costs. Revenue comes from licensing fees per employee or enterprise contracts.
Provide consulting services to healthcare organizations by analyzing Oura Ring data to support patient monitoring and treatment plans. Revenue is generated through project-based fees or ongoing data analysis subscriptions.
š¬ Integration Tip
Always set the PERSONAL_ACCESS_TOKEN environment variable from secrets files before running commands, and use the --json flag for reliable data parsing in automated workflows.
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