Oura Ring MCP Server

Overview

The Oura Ring MCP server connects Claude to your Oura Ring data, allowing you to query and analyze your personal health metrics. This integration enables you to have meaningful conversations about your sleep quality, readiness scores, and overall resilience based on actual biometric data collected by your Oura Ring.

Prerequisites

Before using this MCP server, you'll need:

1. An Oura Ring and an active Oura account
2. An Oura API token (Personal Access Token)

Getting Your Oura API Token

To obtain your Oura API token:

1. Visit the Oura Developer Portal
2. Sign in with your Oura account
3. Create a Personal Access Token
4. Copy the token for use in the MCP server configuration

Installation

For Claude Desktop

1. Install the MCP server using pip:

   pip install oura-mcp-server
   

2. Update your Claude Desktop configuration file:

   • On macOS: Located at ~/Library/Application Support/Claude/claude_desktop_config.json
   • On Windows: Located at %APPDATA%/Claude/claude_desktop_config.json

3. Add the Oura MCP server configuration to your config file, replacing YOUR_OURA_API_TOKEN with your actual token.

Usage Examples

Once the MCP server is configured, you can ask Claude questions about your Oura Ring data:

• "How did I sleep last night?"
• "What was my readiness score for the past week?"
• "Show me my sleep data from March 1st to March 7th"
• "What's my resilience score today?"
• "How has my sleep quality changed over the past month?"
• "What's the correlation between my readiness score and my sleep duration?"

Troubleshooting

If you encounter issues:

1. Authentication Errors: Verify your Oura API token is correct and hasn't expired
2. Date Format Errors: Ensure dates are in ISO format (YYYY-MM-DD)
3. No Data Available: The Oura API might not have data for the requested date range
4. Connection Issues: Check your internet connection and try again

Privacy Considerations

This MCP server accesses your personal health data. Your data is processed locally and is only shared with Claude during your conversation. No data is stored by the MCP server itself.