Oura MCP Server
About
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.
Details
- Author
- tomekkorbak
- GitHub stars
- 38
- Downloads
- 245
- Categories
- Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Oura MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"oura mcp server": {
"oura": {
"command": "uvx",
"args": [
"oura-mcp-server"
],
"env": {
"OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
}
}
}
}
}McpServers
{
"oura": {
"command": "uvx",
"args": [
"oura-mcp-server"
],
"env": {
"OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
}
}
}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.
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 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).
Today's Data Queries
- 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
Usage
You'll need an Oura API token to use this server. You can obtain one by:
1. Going to the Oura Developer Portal
2. 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:
{
"mcpServers": {
"oura": {
"command": "uvx",
"args": [
"oura-mcp-server"
],
"env": {
"OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
}
}
}
}
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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
