> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Oura **Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app. ## Sample use cases * Show me my readiness score and HRV trend over the last 7 days. * Pull last night's sleep stages and total sleep time. * Find days in the last 30 with high stress scores and overlay with calendar density. ## Available Tools #### list_daily_activity List daily activity summaries including steps, calories, and activity scores. Filter by start_date/end_date. Use next... #### get_daily_activity Get a specific daily activity record by document ID. Use list_daily_activity to find valid IDs. #### list_heartrate List heart rate samples with BPM and source. Filter by start_datetime/end_datetime (ISO 8601). Use next_token for pag... #### list_daily_readiness List daily readiness scores with contributors like HRV balance, body temperature, and sleep. Filter by start_date/end... #### get_daily_readiness Get a specific daily readiness record by document ID. Use list_daily_readiness to find valid IDs. #### list_rest_mode_periods List rest mode periods when the user activated rest mode. Filter by start_date/end_date. Use next_token for pagination. #### get_rest_mode_period Get a specific rest mode period by document ID. Use list_rest_mode_periods to find valid IDs. #### list_sessions List guided breathing and meditation sessions. Filter by start_date/end_date. Use next_token for pagination. #### get_session Get a specific session by document ID. Use list_sessions to find valid IDs. #### list_daily_sleep List daily sleep scores with pagination. Filter by start_date/end_date (YYYY-MM-DD). Use next_token from page_info fo... #### get_daily_sleep Get a specific daily sleep record by document ID. Use list_daily_sleep to find valid IDs. #### list_sleep_sessions List detailed sleep sessions with heart rate, HRV, and sleep stages. Filter by start_date/end_date. Use next_token fo... #### get_sleep_session Get a specific sleep session by document ID with detailed heart rate, HRV, and sleep stage data. Use list_sleep_sessi... #### list_sleep_time List sleep time recommendations with optimal bedtime windows. Filter by start_date/end_date. Use next_token for pagin... #### get_sleep_time Get a specific sleep time recommendation by document ID. Use list_sleep_time to find valid IDs. #### list_daily_spo2 List daily SpO2 (blood oxygen) readings. Filter by start_date/end_date. Use next_token for pagination. #### get_daily_spo2 Get a specific daily SpO2 record by document ID. Use list_daily_spo2 to find valid IDs. #### list_daily_stress List daily stress summaries with stress and recovery levels. Filter by start_date/end_date. Use next_token for pagina... #### get_daily_stress Get a specific daily stress record by document ID. Use list_daily_stress to find valid IDs. #### list_tags List user-created tags. Filter by start_date/end_date. Use next_token for pagination. #### get_tag Get a specific tag by document ID. Use list_tags to find valid IDs. #### list_enhanced_tags List enhanced tags with additional metadata like tag type and comments. Filter by start_date/end_date. Use next_token... #### get_enhanced_tag Get a specific enhanced tag by document ID. Use list_enhanced_tags to find valid IDs. #### get_personal_info Get the authenticated Oura user's personal info including age, weight, height, and biological sex. #### list_workouts List workouts including activity type, calories, distance, and intensity. Filter by start_date/end_date. Use next_tok... #### get_workout Get a specific workout by document ID. Use list_workouts to find valid IDs.