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 metrics
get_readiness_data / get_today_readiness_data - Access readiness scores and contributing factors
get_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
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Oura MCP Server what's my sleep score for today?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
简体中文 | English | 한국어
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.
Call for translators! We're looking for translators to help translate this spec for everyone!
Read our documentation in the following languages:
Related MCP server: Oura Ring MCP Server
The server exposes the following tools:
get_sleep_data(start_date: str, end_date: str): Get sleep data for a specific date range
get_readiness_data(start_date: str, end_date: str): Get readiness data for a specific date range
get_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).
get_today_sleep_data(): Get sleep data for today
get_today_readiness_data(): Get readiness data for today
get_today_resilience_data(): Get resilience data for today
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
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
{
"mcpServers": {
"oura": {
"command": "uvx",
"args": ["oura-mcp-server"],
"env": {
"OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
}
}
}
}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?"
The server provides human-readable error messages for common issues:
Invalid date formats
API authentication errors
Network connectivity problems
This project is licensed under the MIT License - see the LICENSE file for details.
Get readiness data for a specific date range.
Args:
start_date: Start date in ISO format (YYYY-MM-DD)
end_date: End date in ISO format (YYYY-MM-DD)
Returns:
Dictionary containing readiness data
Inputs: start_date (required), end_date (required).
Get resilience data for a specific date range.
Args:
start_date: Start date in ISO format (YYYY-MM-DD)
end_date: End date in ISO format (YYYY-MM-DD)
Returns:
Dictionary containing resilience data
Inputs: start_date (required), end_date (required).
Get sleep data for a specific date range.
Args:
start_date: Start date in ISO format (YYYY-MM-DD)
end_date: End date in ISO format (YYYY-MM-DD)
Returns:
Dictionary containing sleep data
Inputs: start_date (required), end_date (required).
Get readiness data for today.
Returns:
Dictionary containing readiness data for today
Inputs: no named parameters.
Get resilience data for today.
Returns:
Dictionary containing resilience data for today
Inputs: no named parameters.
Get sleep data for today.
Returns:
Dictionary containing sleep data for today
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
The tools are clearly organized around three data types (readiness, resilience, sleep) with two temporal variants (date range vs. today), making them mostly distinct. However, the 'get_today_*' tools could be seen as overlapping with the date-range versions if an agent specifies today's date, though their dedicated purpose reduces confusion.
All tools follow a consistent verb_noun pattern with 'get_' prefix, and the naming is systematic across data types and temporal variants (e.g., get_readiness_data, get_today_readiness_data). There are no deviations in style or convention.
With 6 tools, this is well-scoped for an Oura data server, covering three key metrics with both historical and current-day access. Each tool serves a clear purpose without redundancy, fitting typical expectations for such a domain.
The server covers the core read operations for readiness, resilience, and sleep data with both date-range and today-specific queries, which is appropriate for a fitness/health tracking domain. A minor gap is the lack of write or update tools (e.g., to set goals or log activities), but as a read-only data retrieval surface, it is largely complete.
Read sleep, readiness, activity, stress, heart rate and workouts from the Oura Ring.
Connect your Oura Ring account securely in minutes. Enable authorized access to your sleep, activi…
Connect your Oura Ring account and enable access to your wellness data in apps and automations. In…
Connect your wearables, rings and training apps, then ask your AI about your own health data.
