oura-ring-mcp

MCP.Pizza Chef: mitchhankins01

You can connect your Oura Ring with AI assistants like Claude to get easy-to-understand insights about your sleep, recovery, activity, and health. Instead of raw data, you receive clear summaries, trend analyses, and personalized health patterns. Setup requires adding a small config snippet to Claude Desktop and authenticating with your Oura account via token or OAuth. No complex installs needed, and it works right inside apps you already use.

Other

Use This MCP server To

Check how well I slept last night with detailed sleep stages See if I'm recovered enough to exercise today Track my daily activity like steps and calories Compare my sleep quality this week versus last week Find unusual patterns or anomalies in my health data Understand how habits like alcohol affect my sleep Get weekly summaries and trends of my readiness and sleep

README

Oura MCP Server

npm version MCP Registry CI

An MCP server that connects your Oura Ring to Claude and other AI assistants. Get human-readable insights about your sleep, readiness, and activity—not just raw JSON.

Features

Demo

  • Smart formatting - Durations in hours/minutes, scores with context ("85 - Optimal")
  • Sleep analysis - Sleep stages, efficiency, HRV, and biometrics
  • Readiness tracking - Recovery scores and contributor breakdown
  • Activity data - Steps, calories, and intensity breakdown
  • Health metrics - Heart rate, SpO2, stress, cardiovascular age
  • Smart analysis - Anomaly detection, correlations, trend analysis
  • Tags support - Compare metrics with/without conditions

See example outputs — what Claude returns for sleep, readiness, weekly summaries, and smart analysis

Quick Start

1. Install

npm install -g oura-ring-mcp

Or use directly with npx (no install needed):

npx oura-ring-mcp

2. Authenticate with Oura

Option A: Personal Access Token (simpler)

  1. Go to cloud.ouraring.com/personal-access-tokens
  2. Create a new token
  3. Set OURA_ACCESS_TOKEN in your Claude Desktop config (see below)

Option B: OAuth CLI Flow

oura-ring-mcp FAQ

Can I use this to get detailed insights about my sleep and recovery?
Yes — it provides human-readable analysis of your sleep stages, readiness scores, and activity data through Claude.ai and Claude Desktop.
Can I compare my sleep patterns over different weeks?
Yes — it supports comparing sleep data week-to-week and analyzing trends or anomalies.
Which apps work with this Oura Ring MCP server?
It works with Claude.ai and Claude Desktop, letting those assistants access your Oura data.
Do I need an Oura account or token to use this?
Yes — you need to authenticate with your Oura account using a personal access token or OAuth credentials.
How hard is it to set up?
Setup involves copying a small config snippet into Claude Desktop and providing your Oura token or OAuth info, so it's copy-paste-config difficulty.
Do I need to install anything?
You can run it directly with npx without installing, or install globally via npm if preferred.