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