Oura Ring Plugin for Obsidian

Add your oura ring stats to an Obsidian note for any dates. The documentation for the Oura Ring API is available at API Documentation.

Features

• Fetch your Oura Ring data using your personal access token
  • To create a personal access token visit and login to https://cloud.ouraring.com/personal-access-tokens and copy the token into the settings for this plugin
• Insert the data in a page which is formatted YYYY-MM-DD
• Or insert into any page and it will use whatever today's date is

Oura API Variables

Sleep

Name	Field
Sleep Day	sleep_day
Sleep Score	sleep_score
Sleep Timestamp	sleep_timestamp
Deep Sleep	sleep_contributors_deep_sleep
Efficiency	sleep_contributors_efficiency
Latency	sleep_contributors_latency
REM Sleep	sleep_contributors_rem_sleep
Restfulness	sleep_contributors_restfulness
Timing	sleep_contributors_timing
Total Sleep	sleep_contributors_total_sleep

Readiness

Name	Field
Readiness Day	readiness_day
Readiness Score	readiness_score
Temperature Deviation	readiness_temperature_deviation
Temperature Trend Deviation	readiness_temperature_trend_deviation
Readiness Timestamp	readiness_timestamp
Activity Balance	readiness_contributors_activity_balance
Body Temperature	readiness_contributors_body_temperature
HRV Balance	readiness_contributors_hrv_balance
Previous Day Activity	readiness_contributors_previous_day_activity
Previous Night	readiness_contributors_previous_night
Recovery Index	readiness_contributors_recovery_index
Resting Heart Rate	readiness_contributors_resting_heart_rate
Sleep Balance	readiness_contributors_sleep_balance

Activities

Name	Field
Class (5 min)	activities_class_5_min
Score	activities_score
Active Calories	activities_active_calories
Average MET Minutes	activities_average_met_minutes
Equivalent Walking Distance	activities_equivalent_walking_distance
High Activity MET Minutes	activities_high_activity_met_minutes
High Activity Time	activities_high_activity_time
Inactivity Alerts	activities_inactivity_alerts
Low Activity MET Minutes	activities_low_activity_met_minutes
Low Activity Time	activities_low_activity_time
Medium Activity MET Minutes	activities_medium_activity_met_minutes
Medium Activity Time	activities_medium_activity_time
Meters to Target	activities_meters_to_target
Non-Wear Time	activities_non_wear_time
Resting Time	activities_resting_time
Sedentary MET Minutes	activities_sedentary_met_minutes
Sedentary Time	activities_sedentary_time
Steps	activities_steps
Target Calories	activities_target_calories
Target Meters	activities_target_meters
Total Calories	activities_total_calories
Day	activities_day
Timestamp	activities_timestamp
MET Interval	activities_met_interval
MET Items	activities_met_items
MET Timestamp	activities_met_timestamp
Meet Daily Targets	activities_contributors_meet_daily_targets
Move Every Hour	activities_contributors_move_every_hour
Recovery Time	activities_contributors_recovery_time
Stay Active	activities_contributors_stay_active
Training Frequency	activities_contributors_training_frequency
Training Volume	activities_contributors_training_volume

Installation

The Oura Plugin for Obsidian release is pending review.

Manual Installation

Two methods and the first one is easier:

Method 1

• Enable community plugins and install Obsidian42 - BRAT
• Go to settings and under Beta Plugin List click "Add Beta plugin" and type kinabalu/obsidian-oura-plugin

Method 2

• Create an obsidian-oura-plugin folder under .obsidian/plugins in your vault. Add the main.js, manifest.json, and the styles.css files from the latest release to the folder.

Usage

Open the command palette (⌃+P or ⌘+P) and type Oura Ring. Execute the Oura Ring: Insert Oura Ring Stats action and your data will be written to your current cursor location.

Say Thanks 🙏

If you like this plugin and would like to buy me a coffee, you can!