How do I install the Oura CLI skill?

Run npx skillmds@latest add ruhrpotter/oura-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Oura CLI skill do?

Oura Ring CLI Skill It is listed under Coding & Dev Tools on SkillMD.

Is Oura CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Oura CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Oura CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Oura CLI?

ruhrpotter (@ruhrpotter) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Oura CLI by ruhrpotter — Agent Skill

Name: Oura CLI
Rating: 4.2 (5 reviews)
Author: ruhrpotter

File contents

Oura Ring CLI Skill

Description

This 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

Prerequisite

The CLI must be authenticated. If a command fails with an auth error, notify the user to run ./oura auth login.

Syntax

./oura get <category> [flags]

Arguments

--start <YYYY-MM-DD>: REQUIRED for most time-series data. The start date of the range.
--end <YYYY-MM-DD>: OPTIONAL. The end date of the range. If omitted, it may default to the start date or return a single day depending on context.

Agent Instructions

Date Resolution: You MUST resolve all relative date terms (e.g., "today", "yesterday", "last week", "this month") into absolute YYYY-MM-DD string format based on the current operational date.
Date ranges:
- For "today": Set --start to today's date.
- For "yesterday": Set --start to yesterday's date.
- For "last 7 days": Set --start to 7 days ago and --end to today.
Path: Assume the binary is ./oura in the current working directory unless the user specifies otherwise.
Output: The CLI returns JSON. Parse the JSON data array to formulate a natural language response.

Examples

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-15

User Request: "What is my readiness score today?" Context: Today is 2024-03-15. Command:

./oura get readiness --start 2024-03-15

User Request: "Show my heart rate for the first week of January 2024." Command:

./oura get heartrate --start 2024-01-01 --end 2024-01-07

User Request: "Who am I?" Command:

./oura get personal

---name: oura-clidescription: Oura Ring CLI Skill---# Oura Ring CLI Skill## DescriptionThis 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](https://github.com/ruhrpotter/oura-cli)## PrerequisiteThe CLI must be authenticated. If a command fails with an auth error, notify the user to run `./oura auth login`.## Syntax`./oura get <category> [flags]`## Categories- `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).## Arguments- `--start <YYYY-MM-DD>`: REQUIRED for most time-series data. The start date of the range.- `--end <YYYY-MM-DD>`: OPTIONAL. The end date of the range. If omitted, it may default to the start date or return a single day depending on context.## Agent Instructions1. **Date Resolution**: You **MUST** resolve all relative date terms (e.g., "today", "yesterday", "last week", "this month") into absolute `YYYY-MM-DD` string format based on the current operational date.2. **Date ranges**: - For "today": Set `--start` to today's date. - For "yesterday": Set `--start` to yesterday's date. - For "last 7 days": Set `--start` to 7 days ago and `--end` to today.3. **Path**: Assume the binary is `./oura` in the current working directory unless the user specifies otherwise.4. **Output**: The CLI returns JSON. Parse the JSON `data` array to formulate a natural language response.## Examples**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**:```bash./oura get sleep --start 2024-03-15```**User Request**: "What is my readiness score today?"**Context**: Today is 2024-03-15.**Command**:```bash./oura get readiness --start 2024-03-15```**User Request**: "Show my heart rate for the first week of January 2024."**Command**:```bash./oura get heartrate --start 2024-01-01 --end 2024-01-07```**User Request**: "Who am I?"**Command**:```bash./oura get personal```

Frequently asked questions

Oura CLI