oura_get_sleep_time
Retrieve Oura's optimal bedtime window and recommendation to see if you are going to bed at the right time based on your circadian data.
Instructions
Oura's own bedtime guidance: the optimal bedtime window and what it recommends.
Use to answer "am I going to bed at the right time?" — distinct from
oura_get_daily_summary's bedtime, which reports when you ACTUALLY slept. This is
what Oura thinks you SHOULD do, derived from your circadian/temperature data.
CSV columns: date, optimal_bedtime_start, optimal_bedtime_end (local HH:MM; blank when Oura couldn't compute a window), recommendation, status
recommendation is one of: follow_optimal_bedtime — you're aligned; keep the current window earlier_bedtime — go to bed earlier later_bedtime — go to bed later earlier_wake_up_time / later_wake_up_time — adjust the wake side instead
status is one of: optimal_found — a concrete window was computed (times populated) only_recommended_found — Oura has a direction but NOT enough data for a window, so the time columns are blank. This is normal, not an error. not_enough_nights / no_data — insufficient history in the range.
Note: Oura returns these times as raw second-offsets from local midnight; this tool
decodes them to HH:MM. A run of identical earlier_bedtime rows means Oura has been
persistently flagging late sleep timing — worth reading as a trend, not a single day.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_date | No | ISO end date (YYYY-MM-DD), inclusive. Defaults to today. | |
| start_date | No | ISO start date (YYYY-MM-DD). Defaults to a 30-day window ending at end_date. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |