elizabethtrykin_oura_mcp

elizabethtrykin_oura_mcp

by elizabethtrykin
An MCP server for accessing and managing Oura Ring health data via the Model Context Protocol.

Oura Ring Data MCP Server

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

Overview

The Oura Ring Data MCP Server is a tool designed to integrate Oura Ring health data with the Model Context Protocol (MCP). This server allows users to access and utilize their Oura Ring data programmatically, enabling integration with other applications and services.

Setup

Prerequisites

  • Node.js (v16+)
  • Oura account

Installation

  1. Clone the repository:
    bash git clone https://github.com/elizabethtrykin/oura-mcp.git
  2. Install dependencies and build the project:
    bash npm install npm run build

Configuration

Obtaining Credentials

  1. Log in to the Oura Cloud Console.
  2. Obtain either:
  3. A Personal Access Token (for testing).
  4. OAuth2 Credentials (for production).

Environment Variables

Create a .env file with the following content:

# 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

Run the test script with the desired tool and date:

node test.js <tool_name> <date>

Example:

node test.js get_daily_sleep 2023-05-01

Claude Desktop Integration

Add the following configuration to Claude Desktop's settings (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. Refer to the MCP docs for more 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).

About

An MCP server for Oura Ring data.

Resources

Stars

1 star

Watchers

1 watching

Forks

1 fork

Report repository

Releases

No releases published.

Packages

No packages published.

Languages

Features & Capabilities

Categories
mcp_server model_context_protocol oura_ring health_data typescript javascript api_integration claude

Implementation Details

View on GitHub

Stats

0 Views
0 Favorites
1 GitHub Stars

Repository Info

elizabethtrykin Organization

Similar Servers

continuedev_continue by continuedev
0
cherryhq_cherry_studio by CherryHQ
0
bytedance_ui_tars_desktop by bytedance
0
2025© BestAI