oura-mcp-server is 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 the Oura API.
Key capabilities: The server exposes the following tools:
Date range queries:
- get_sleep_data(start_date: str, end_date: str): Get sleep data for the specified date range
- get_readiness_data(start_date: str, end_date: str): Get readiness data for the specified date range
- get_resilience_data(start_date: str, end_date: str): Get resilience data for the specified date range Dates must use ISO format (YYYY-MM-DD).
Today's data queries:
- get_today_sleep_data(): Get today's sleep data
- get_today_readiness_data(): Get today's readiness data
- get_today_resilience_data(): Get today's resilience data
Usage: Using this server requires an Oura API token. To get one: go to the Oura Developer Portal and create a Personal Access Token.
Configuring in Claude for Desktop: Update claude_desktop_config.json (on macOS located at ~/Library/Application Support/Claude/claude_desktop_config.json, on Windows located at %APPDATA%/Claude/claude_desktop_config.json) and add the corresponding configuration.
Example queries: After connecting, you can ask Claude questions such as:
- "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, including: invalid date format, API authentication errors, and network connection problems.
License: This project uses the MIT License; see the LICENSE file for details.
