README

Oura MCP Server

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

Setup

Prerequisites

Node.js (v16+)
Oura account

Installation

Clone the repository
Run:

npm install
npm run build

Configuration

Obtaining Credentials

Log in to Oura Cloud Console
Get either:
- Personal Access Token (for testing)
- OAuth2 Credentials (for production)

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).

Oura MCP Server

README

Oura MCP Server

Setup

Prerequisites

Installation

Configuration

Obtaining Credentials

Environment Variables

Usage

Testing

Claude Desktop Integration

Available Resources

Available Tools

Recommended Servers