Skip to main content
Glama

@louis030195/oura-mcp

Dead simple MCP (Model Context Protocol) server for Oura Ring. Get your sleep, readiness, and activity data directly from Claude, ChatGPT, or any LLM that supports MCP.


πŸ’– Support This Project

If you find this MCP server useful, please consider supporting its development!

Support via Stripe

πŸ‘‰ Click here to support this project

Your support helps maintain and improve this tool. Thank you! πŸ™


Features

  • 😴 Sleep data (score, REM, deep, light sleep stages)

  • ⚑ Readiness score (HRV, resting HR, body temperature)

  • πŸƒ Activity data (steps, calories, activity score)

  • ❀️ Heart rate monitoring

Related MCP server: Oura MCP Server

Installation

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "oura": {
      "command": "npx",
      "args": ["-y", "@louis030195/oura-mcp"],
      "env": {
        "OURA_API_KEY": "your-oura-api-key"
      }
    }
  }
}

Claude Code

# Install globally in user scope with API key
claude mcp add -s user oura npx -e OURA_API_KEY=your-oura-api-key -- -y @louis030195/oura-mcp

Get Your Oura API Key

  1. Go to Oura Personal Access Tokens

  2. Click "Create New Personal Access Token"

  3. Copy your token (starts with something like 4SKHEL...)

Usage

Once configured, you can use natural language to access your Oura data:

  • "How did I sleep last night?"

  • "Show me my sleep data for the past week"

  • "What's my readiness score today?"

  • "How many steps did I take yesterday?"

  • "Show my heart rate data from last week"

Tools

oura_sleep

Get daily sleep data including sleep score, sleep stages (REM, deep, light), efficiency, and timing.

Parameters:

  • start_date (required): Start date in YYYY-MM-DD format

  • end_date (optional): End date in YYYY-MM-DD format

oura_readiness

Get daily readiness score, HRV balance, resting heart rate, and body temperature deviation.

Parameters:

  • start_date (required): Start date in YYYY-MM-DD format

  • end_date (optional): End date in YYYY-MM-DD format

oura_activity

Get daily activity data including steps, calories burned, and activity score.

Parameters:

  • start_date (required): Start date in YYYY-MM-DD format

  • end_date (optional): End date in YYYY-MM-DD format

oura_heartrate

Get heart rate data over time.

Parameters:

  • start_date (required): Start date in YYYY-MM-DD format

  • end_date (optional): End date in YYYY-MM-DD format

Development

# Clone the repo
git clone https://github.com/louis030195/oura-mcp.git
cd oura-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
OURA_API_KEY=your-api-key npm start

License

MIT

Author

Louis Beaumont

Available Tools

4 tools
oura_activityB

Get daily activity data including steps, calories, and activity score

Inputs: start_date (required), end_date.

oura_heartrateC

Get heart rate data over time

Inputs: start_date (required), end_date.

oura_readinessB

Get daily readiness score, HRV balance, resting heart rate, and body temperature

Inputs: start_date (required), end_date.

oura_sleepC

Get daily sleep data including sleep score, sleep stages (REM, deep, light), and sleep duration

Inputs: start_date (required), end_date.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool targets a distinct Oura data domain (sleep, readiness, activity, heart rate), so an agent can generally tell them apart. There is slight potential overlap because readiness includes resting heart rate and HRV, while heartrate returns heart rate over time, but the descriptions make the intended distinction clear enough.

    Naming Consistency5/5

    All four tools follow the same predictable oura_<noun> pattern (oura_sleep, oura_readiness, oura_activity, oura_heartrate). There are no mixed conventions, camelCase, or inconsistent verbs.

    Tool Count4/5

    Four tools is a reasonable, focused set for a read-only Oura data server covering the main daily metrics. It is slightly thin compared to the full breadth of Oura data types, but not problematic.

    Completeness3/5

    The core daily metrics (sleep, readiness, activity, heart rate) are covered, but obvious Oura data surface areas are missing, such as workouts, tags, sessions, and SpO2. The server is read-only, which is acceptable for Oura's API, but the absence of a workout or tag endpoint is a notable gap.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables querying sleep, readiness, and resilience data from the Oura API via the Model Context Protocol (MCP), allowing natural language interaction and seamless integration with tools like Claude.
      6
      39
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to Oura Ring health data, including sleep, activity, readiness, and stress metrics via the Model Context Protocol. It enables users to query their personal biometric information and daily health summaries through natural language in MCP-compatible clients.
      ISC