Oura Ring

What is oura-mcp-server?

oura-mcp-server is a Model Controller Protocol (MCP) server that allows AI assistants, specifically those like Claude, to securely access and analyze your Oura Ring health data. It provides a structured way to fetch, understand, and visualize your health metrics, bridging the gap between your wearable data and AI-driven insights.

How to use oura-mcp-server?

To use oura-mcp-server, you need Node.js v18 or higher and an Oura Ring account with a Personal Access Token. After cloning the repository and installing dependencies, you'll configure your Oura API token in a .env file. The server can then be built and started. Once running, AI assistants can interact with it to query and analyze your Oura Ring data. Example prompts demonstrate how to ask for sleep data analysis, correlation between meals and readiness, stress level comparisons, and data visualizations.

Key Features of oura-mcp-server

• Secure Data Access: Provides secure access to your Oura Ring data.
• Pre-defined Prompts: Offers pre-defined prompts for common health analysis tasks.
• Customizable Queries: Allows for customizable queries to gain specific health insights.
• Correlation Analysis: Supports analyzing correlations between different health metrics.
• Time Unit Handling: Properly handles time units and calculation guidelines for accurate data interpretation.
• Visualization Capabilities: Enables AI assistants to generate visual charts of health metrics.

Use Cases of oura-mcp-server

oura-mcp-server is ideal for:

• Personal Health Monitoring: Users can gain deeper insights into their sleep, activity, and readiness.
• AI-driven Health Coaching: AI assistants can leverage the server to provide personalized health advice and analysis.
• Research and Analysis: Researchers can use the structured data access for health studies.
• Custom Health Applications: Developers can build applications that integrate Oura Ring data with AI capabilities.

FAQ about oura-mcp-server

Q: What are the prerequisites for running oura-mcp-server? A: You need Node.js v18 or higher and an Oura Ring account with a Personal Access Token.

Q: How do I get an Oura Personal Access Token? A: You can obtain one from the Oura Developer website after logging in with your Oura account.

Q: Can Claude visualize my health data? A: Yes, Claude can create visual charts by simply asking it to "visualize" or "create a chart" of specific metrics.

Q: How are duration fields and percentages handled in the data? A: All duration fields are in seconds and converted to hours/minutes for display. Sleep percentages are calculated using total_sleep_duration as the denominator, and sleep efficiency is calculated as (total_sleep_duration / time_in_bed * 100).

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.