About Oura Ring
Oura Ring is an MCP server published by rajvirtual in the Developer Tools category: oura Ring Model Controller Protocol (MCP).
The repository has 15 stars and 6 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/rajvirtual/oura-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Oura Ring
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository yesterday. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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
-
Clone the repository:
git clone https://github.com/yourusername/oura-mcp-server.git cd oura-mcp-server -
Install dependencies:
npm install -
Create a
.envfile in the root directory with your Oura API token:OURA_TOKEN=your_personal_access_token_here -
Build the project:
npm run build -
Start the server:
npm start
Getting an Oura Personal Access Token
- Go to the Oura Developer website
- Log in with your Oura account
- Create a new Personal Access Token
- Copy the token to your
.envfile
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.
README fetched from the repository yesterday. The original is authoritative.