Fetch Oura Ring readiness/sleep + 7-day readiness trends via Oura Cloud API V2, and generate a Morning Readiness Brief.
This skill provides a small, public-facing reference implementation for pulling Readiness, Sleep, and 7-day Readiness trends from the Oura V2 API (/v2/usercollection/*).
CLI (raw data):
python3 skills/oura-ring/cli.py --format json --pretty readinesspython3 skills/oura-ring/cli.py --format json --pretty sleeppython3 skills/oura-ring/cli.py --format json --pretty trendspython3 skills/oura-ring/cli.py --format json --pretty resiliencepython3 skills/oura-ring/cli.py --format json --pretty stressMorning brief (formatted):
./skills/oura-ring/scripts/morning_brief.shmacOS/Homebrew Python often blocks system-wide pip install (PEP 668), so use a virtualenv:
python3 -m venv skills/oura-ring/.venv
source skills/oura-ring/.venv/bin/activate
python -m pip install -r skills/oura-ring/requirements.txt
.envCreate skills/oura-ring/.env:
cp skills/oura-ring/.env.example skills/oura-ring/.env
# then edit skills/oura-ring/.env
The CLI reads:
OURA_TOKEN (required)OURA_BASE_URL (optional; defaults to https://api.ouraring.com/v2/usercollection)Oura V2 uses OAuth2 bearer tokens.
http://localhost:8080/callback).CLIENT_ID, REDIRECT_URI, and scope):