mcpField
O
Oura MCP Server

Oura MCP Server

Local
github.com/elizabethtrykinHealth51Updated 84w ago
Repository

About Oura MCP Server

Oura MCP Server is an MCP server for reading Oura Ring data. It is aimed at users who want to query sleep, activity and recovery data from an AI client. It supports both personal access tokens and OAuth2 credentials.

Key features

  1. 01Exposes daily sleep, activity and readiness resources
  2. 02Supports personal access token and OAuth2 authentication
  3. 03Queries data by start and end date
  4. 04Includes Claude Desktop configuration example

Use cases

  1. 01Reviewing sleep summaries for a date range in Claude Desktop
  2. 02Comparing workout records with readiness scores
  3. 03Checking stress, SpO2 or cardiovascular age metrics

MCP support

This project is an MCP server that exposes Oura data as resources and tools for MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Oura MCP Server

A Model Context Protocol (MCP) server for accessing Oura Ring data.

Setup

Prerequisites
  • Node.js (v16+)
  • Oura account
Installation
  1. Clone the repository
  2. Run:
npm install
npm run build

Configuration

Obtaining Credentials
  1. Log in to Oura Cloud Console
  2. Get either:
Environment Variables

Create a .env file:

# Option 1: Personal Access Token
OURA_PERSONAL_ACCESS_TOKEN=your_token

# Option 2: OAuth2 credentials
OURA_CLIENT_ID=your_client_id
OURA_CLIENT_SECRET=your_client_secret
OURA_REDIRECT_URI=http://localhost:3000/callback

Usage

Testing
node test.js <tool_name> <date>

Example: node test.js get_daily_sleep 2023-05-01

Claude Desktop Integration

Add to Claude Desktop's config (Settings → Developer → Edit Config):

{
    "mcpServers": {
        "oura": {
            "command": "node",
            "args": ["/absolute/path/to/oura-mcp/build/index.js"],
            "env": {"OURA_PERSONAL_ACCESS_TOKEN": "your_token"}
        }
    }
}

Restart Claude Desktop after saving. See MCP docs for details.

Available Resources

  • personal_info - User profile
  • daily_activity - Activity summaries
  • daily_readiness - Readiness scores
  • daily_sleep - Sleep summaries
  • sleep - Detailed sleep data
  • sleep_time - Sleep timing
  • workout - Workout data
  • session - Session data
  • daily_spo2 - SpO2 measurements
  • rest_mode_period - Rest periods
  • ring_configuration - Ring config
  • daily_stress - Stress metrics
  • daily_resilience - Resilience metrics
  • daily_cardiovascular_age - CV age
  • vO2_max - VO2 max data

Available Tools

For date-based resources, use tools like get_daily_sleep with startDate and endDate parameters (YYYY-MM-DD).

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.