oura-mcp-server

Oura Ring Model Controller Protocol (MCP) Server

This server enables AI assistants to access and analyze your Oura Ring data through the Model Controller Protocol (MCP). It provides a structured way to fetch and understand your health metrics.

Features

• Secure access to your Oura Ring data
• Pre-defined prompts for common health analysis tasks
• Customizable queries for specific health insights
• Support for analyzing correlations between different metrics
• Proper handling of time units and calculation guidelines
• Visualization capabilities for health metrics

Getting Started

Prerequisites

• Node.js v18 or higher
• An Oura Ring account with Personal Access Token

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/oura-mcp-server.git
   cd oura-mcp-server
   

2. Install dependencies:

   npm install
   

3. Create a .env file in the root directory with your Oura API token:

   OURA_TOKEN=your_personal_access_token_here
   

4. Build the project:

   npm run build
   

5. Start the server:

   npm start
   

Getting an Oura Personal Access Token

1. Go to the Oura Developer website
2. Log in with your Oura account
3. Create a new Personal Access Token
4. Copy the token to your .env file

Example Prompts

You can ask Claude things like:

• "Show me my sleep data for the last week and explain what it means"
• "Analyze how my meals affect my readiness scores"
• "Compare my stress levels on workdays versus weekends"
• "Show me my heart rate during sleep for nights when I had alcohol"
• "Visualize my sleep efficiency trends for the past month" (Claude will generate charts!)
• "Create a visualization comparing my readiness scores after different meals"

Data Visualization

Claude can create visual charts to help you understand your health data. Simply ask Claude to "visualize" or "create a chart" of specific metrics. For example:

• "Visualize my sleep stages over the past week"
• "Create a chart showing the correlation between HRV and sleep quality"
• "Make a bar graph comparing my activity scores by day of week"
• "Plot my resting heart rate against stress levels"

Data Handling Guidelines

This server follows these key guidelines:

• All duration fields are in seconds and converted to hours/minutes for display
• Sleep percentages are calculated using total_sleep_duration as denominator
• Sleep efficiency is calculated as (total_sleep_duration / time_in_bed * 100)
• Custom tags contain meal information in the comment field

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.