Oura Ring 데이터에 액세스하기위한 모델 Context Protocol (MCP) 서버.

설치

# 필수품

• Node.js (v16+)
• Oura 계정

설치

1. 저장소를 복제
2. 실행:

구성

Credentials 획득

1. Oura Cloud Console에 로그인
2. 하나를 얻으십시오:

• 개인 액세스 토큰 (테스트용)
• OAuth2 Credentials (생산)

환경 변수

.env] 파일을 만듭니다:

사용법

테스트

예: node test.js get_daily_sleep 2023-05-01

Claude 데스크탑 통합

Claude Desktop의 구성 추가 (설정 → Developer → Edit Config):

저장 후 Restart Claude 데스크탑. 자세한 내용은 MCP docs를 참조하십시오.

사용 가능한 자원

• personal_info - 사용자 프로필
• daily_activity - 활동 요약
• daily_readiness - 읽음 점수
• daily_sleep - 수면 요약
• sleep - 상세한 수면 데이터
• sleep_time - 수면 타이밍
• workout - 운동 자료
• session - 세션 데이터
• daily_spo2 - SpO2 측정
• rest_mode_period - 휴식 기간
• ring_configuration - 링 구성
• daily_stress - 스트레스 미터
• daily_resilience - 탄력 미터
• daily_cardiovascular_age - CV 연령
• vO2_max - VO2 최대 데이터

사용 가능한 도구

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  

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