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:

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