oura-analytics

Fetch and normalize Cloud data from the Oura API for automated reports and alerts.

6|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/kesslerio/oura-analytics-openclaw-skill --skill oura-analytics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oura-analytics
Source: https://github.com/kesslerio/oura-analytics-openclaw-skill/tree/main
Command: npx skills add https://github.com/kesslerio/oura-analytics-openclaw-skill --skill oura-analytics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pytz, PyYAML, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill consolidates Oura Cloud data (sleep, readiness, activity, HRV) into a unified analytics workflow, automating report generation and alerts to support proactive health decisions.

Core Features & Use Cases

  • Automated data fetch, normalization, and aggregation across sleep, readiness, and activity.
  • Trend analysis and weekly/monthly reporting with configurable alerts for low readiness or sleep efficiency.
  • Daily and hybrid briefings to summarize key metrics and drivers for quick decision-making.

Quick Start

  1. Set your OURA_API_TOKEN environment variable: export OURA_API_TOKEN="your_token_here"
  2. Basic usage to fetch a weekly summary: python {baseDir}/scripts/summary.py --days 7
  3. Generate a weekly report: python {baseDir}/scripts/weekly_report.py --days 7
  4. Optional: enable alerting to Telegram (set TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID).

Frequently Asked Questions about oura-analytics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate daily health briefings using Oura Cloud data?

Automate daily health briefings by fetching and normalizing Oura Cloud data across sleep, readiness, activity, and HRV metrics. This process generates hybrid morning briefings that summarize key health drivers for quick decision-making.

Can I generate multi-week trend reports for HRV and sleep efficiency?

Yes, you can generate multi-week trend reports for HRV and sleep efficiency. The analytics workflow aggregates normalized Oura Cloud data to support long-term trend detection and configurable alerts for low readiness or poor sleep.

Do I need Python 3 and specific libraries to run Oura data analysis scripts?

Yes, you need Python 3 along with the pytz and PyYAML libraries to execute the scripts. These dependencies are required to fetch, normalize, analyze, and report Oura health data from the scripts directory.

How do I set up automated alerts for low readiness scores from Oura?

Set up automated alerts for low readiness scores by configuring the alerting feature within the reporting scripts. You can optionally enable notifications to Telegram by setting the TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID environment variables.

What's the best way to consolidate Oura sleep and activity data into a unified report?

The best way to consolidate Oura sleep and activity data is using a unified analytics workflow that fetches and normalizes data from Oura Cloud. It automates report generation, aggregating multiple metrics into a single weekly or monthly summary.

Why does the Oura analytics script require an API token environment variable?

The Oura analytics script requires the OURA_API_TOKEN environment variable to authenticate and securely fetch your personal health data from Oura Cloud. Without this token, the scripts cannot access your sleep, readiness, or HRV information.