Overview
What is Oura MCP Server?
The Oura MCP Server is a Model Context Protocol server that provides access to the Oura API, enabling language models to query sleep, readiness, and resilience data. It is designed for users of Oura rings who want AI assistants to retrieve their health metrics.
How to use Oura MCP Server?
Install via uvx oura-mcp-server and set the OURA_API_TOKEN environment variable with a personal access token from the Oura Developer Portal. Configure the server in your MCP client (e.g., Claude for Desktop) by adding the command and token to claude_desktop_config.json.
Key features of Oura MCP Server
- Query sleep data for any date range
- Query readiness data for any date range
- Query resilience data for any date range
- Get today’s sleep, readiness, and resilience data
- Human-readable error messages for common issues
- Integrates with Claude for Desktop
Use cases of Oura MCP Server
- Ask your AI assistant for today’s sleep score
- Review readiness trends over the past week
- Analyze sleep patterns over custom date ranges
- Get your current resilience score instantly
FAQ from Oura MCP Server
What data can I query with Oura MCP Server?
You can query sleep, readiness, and resilience data from the Oura API, either for today or for a specific date range in ISO format (YYYY-MM-DD).
How do I authenticate with the Oura API?
You need an Oura API token, which you can create as a Personal Access Token from the Oura Developer Portal. Set it as the environment variable OURA_API_TOKEN when running the server.
What example queries can I use?
Examples include “What’s my sleep score for today?”, “Show me my readiness data for the past week”, and “How was my sleep from January 1st to January 7th?”
What error messages might I see?
The server returns human-readable error messages for invalid date formats, API authentication errors, and network connectivity problems.
How is the server configured for Claude for Desktop?
Add an entry to claude_desktop_config.json with command: "uvx", args: ["oura-mcp-server"], and the OURA_API_TOKEN environment variable.
