Oura MCP Server (Enhanced)

An MCP (Model Context Protocol) server that provides comprehensive access to the Oura Ring API v2. Exposes 17 tools covering sleep, activity, heart rate, stress, SpO2, workouts, and more.

Built with FastMCP and httpx.

Tools

Sleep & Recovery

Tool	Description
get_sleep_data	Detailed sleep sessions -- stages, heart rate, HRV, breathing rate
get_daily_sleep	Daily sleep scores and contributor breakdown
get_sleep_time	Recommended and actual sleep timing windows
get_daily_readiness	Readiness scores and contributors (HRV balance, body temp, etc.)
get_daily_resilience	Recovery capacity and stress tolerance indicators

Activity & Fitness

Tool	Description
get_daily_activity	Steps, calories, active time breakdown, MET levels
get_workouts	Workout sessions with type, calories, distance, duration
get_sessions	Guided sessions (meditation, breathing) with biometrics
get_vo2_max	VO2 max cardiovascular fitness estimates

Health Vitals

Tool	Description
get_heart_rate	Heart rate at 5-minute intervals (uses datetime params)
get_daily_spo2	Daily blood oxygen saturation
get_daily_stress	Daily stress levels and recovery summary
get_daily_cardiovascular_age	Estimated cardiovascular age

User & Device

Tool	Description
get_personal_info	User profile (age, weight, height)
get_ring_configuration	Ring model, color, firmware, setup date
get_rest_mode	Rest mode periods and schedules
get_tags	User-created lifestyle tags and annotations

All tools with date parameters accept optional start_date and end_date in YYYY-MM-DD format. When omitted, the Oura API defaults to recent data.

Setup

Option A: Claude Desktop Extension (recommended)

1. Download the latest oura-mcp-server-enhanced.mcpb from Releases
2. In Claude Desktop, go to Settings > Extensions > Advanced Settings and enable Install from file
3. Back on the Extensions page, click Add from file and select the downloaded .mcpb file
4. Enter your Oura API Token when prompted

Option B: Manual Setup

1. Get an Oura API Token

Go to Oura Personal Access Tokens and create a new token.

2. Install

Requires Python 3.12+ and uv.

git clone https://github.com/josuhr/oura-mcp-server-enhanced.git
cd oura-mcp-server-enhanced
uv venv && uv pip install -e .

3. Configure Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "oura": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/oura-mcp-server-enhanced", "oura-mcp-server"],
      "env": {
        "OURA_API_TOKEN": "your_token_here"
      }
    }
  }
}

Replace /path/to/oura-mcp-server-enhanced with the actual path and your_token_here with your Oura API token.

4. Run Standalone (optional)

export OURA_API_TOKEN="your_token_here"
oura-mcp-server

Building the Extension

To build the .mcpb extension bundle from source:

zip -r oura-mcp-server-enhanced.mcpb manifest.json pyproject.toml uv.lock src/ .python-version -x "src/**/__pycache__/*"

Project Structure

src/oura_mcp_server/
├── __init__.py       # Package entry point
├── server.py         # FastMCP tool definitions and main()
├── client.py         # Async HTTP client for Oura API v2
└── transforms.py     # Human-readable data formatting

Credits

Inspired by tomekkorbak/oura-mcp-server, extended to cover the full Oura API v2.