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

Activity & Fitness

Health Vitals

User & Device

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.

Related MCP server: oura-mcp

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.