This server provides language models with access to Oura ring health data through the Model Context Protocol (MCP). It enables querying of sleep, readiness, and resilience metrics either for custom date ranges (using ISO format YYYY-MM-DD) or for the current day.
Available Tools:
get_sleep_data/get_today_sleep_data- Retrieve sleep scores and metricsget_readiness_data/get_today_readiness_data- Access readiness scores and contributing factorsget_resilience_data/get_today_resilience_data- Get resilience scores and metrics
Key Features:
Natural language interaction for conversational queries
Flexible date range queries for historical data analysis
Quick access to current day's data without specifying dates
Clear error handling for invalid dates, authentication issues, and network problems
Compatible with Claude Desktop and other MCP-compatible applications
Oura MCP Server
A Model Context Protocol (MCP) server that provides access to the Oura API. It allows language models to query sleep, readiness, and resilience data from Oura API.
All Documents
Call for translators! We're looking for translators to help translate this spec for everyone!
Read our documentation in the following languages:
Available Tools
The server exposes the following tools:
Date Range Queries
get_sleep_data(start_date: str, end_date: str): Get sleep data for a specific date rangeget_readiness_data(start_date: str, end_date: str): Get readiness data for a specific date rangeget_resilience_data(start_date: str, end_date: str): Get resilience data for a specific date range
Dates should be provided in ISO format (YYYY-MM-DD).
Today's Data Queries
get_today_sleep_data(): Get sleep data for todayget_today_readiness_data(): Get readiness data for todayget_today_resilience_data(): Get resilience data for today
Usage
You'll need an Oura API token to use this server. You can obtain one by:
Going to the Oura Developer Portal
Creating a Personal Access Token
Claude for Desktop
Update your claude_desktop_config.json (located in ~/Library/Application\ Support/Claude/claude_desktop_config.json on macOS and %APPDATA%/Claude/claude_desktop_config.json on Windows) to include the following
Example Queries
Once connected, you can ask Claude questions like:
"What's my sleep score for today?"
"Show me my readiness data for the past week"
"How was my sleep from January 1st to January 7th?"
"What's my resilience score today?"
Error Handling
The server provides human-readable error messages for common issues:
Invalid date formats
API authentication errors
Network connectivity problems
License
This project is licensed under the MIT License - see the LICENSE file for details.