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

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