oura-setup

Connect an Oura Ring account to Oura Cloud API V2 via OAuth2 token exchange.

2|2|Updated May 13, 2026
One-click install
npx skills add https://github.com/autonomy-cloud/kairos-interface --skill oura-setup-autonomy-cloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oura-setup
Source: https://github.com/autonomy-cloud/kairos-interface/tree/main/skills/oura-setup
Command: npx skills add https://github.com/autonomy-cloud/kairos-interface --skill oura-setup-autonomy-cloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual, error-prone setup required to connect an Oura Ring to an assistant so it can reliably pull personal health metrics from the Oura Cloud API.

Core Features & Use Cases

  • OAuth2 App Registration & Redirect Setup: Helps users register a developer application with the right redirect URI and scopes.
  • Automatic Authorization Code Exchange: Uses a local browser-based OAuth helper to exchange the short-lived auth code for tokens without copy/paste.
  • Token Storage and Refresh Planning: Stores access and refresh tokens in a credential vault and documents refresh and verification via Oura endpoints.
  • Use Case: After setup, an assistant can schedule daily check-ins by fetching readiness, sleep, activity, heart rate, stress, and related health data for a selected date range.

Quick Start

Ask your assistant to walk you through creating an Oura developer app, then run the OAuth helper locally to securely connect and store your Oura tokens for future API calls.

Frequently Asked Questions about oura-setup

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

FAQPage Schema
How do I connect my Oura Ring to the Oura Cloud API V2 using OAuth2?

You can retrieve sleep, readiness, activity, heartrate, workouts, SpO2, stress, and personal info from the Oura Cloud API across specified date ranges by using the stored Bearer token for authorization during your assistant-driven health monitoring workflows.

What's the best way to store Oura API credentials and refresh tokens?

Yes, you can verify your Oura API connection by calling the personal_info endpoint. This confirms your Bearer authorization against api.ouraring.com is valid before fetching broader health data across specified date ranges.

Do I need to register a developer application to pull Oura health data?

The setup process requires running a local browser-based OAuth helper that automatically exchanges the short-lived authorization code for access and refresh tokens without manual copy and paste, securely connecting your account for future API calls.

Why does my Oura API integration fail when retrieving sleep tracking data?

Your Oura API integration may fail if your stored access token has expired. You must implement periodic token refresh using the stored refresh token to maintain valid Bearer authorization against api.ouraring.com for sleep tracking retrieval.