Oura
MCP server for Oura API integration
What is Oura?
Oura is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for oura api integration
MCP server for Oura API integration
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for Oura API integration
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-ouraConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Oura
Oura MCP Server connects AI assistants to the Oura Ring health tracking API, providing access to personal biometric data including sleep scores, readiness scores, and resilience metrics from your Oura Ring device. It exposes simple tools for retrieving both today's data and historical date-range queries, making it easy to ask Claude to analyze sleep trends, track recovery, or summarize weekly health metrics. Oura Ring users who want to query and analyze their health data conversationally—without manually exporting from the Oura app—use this server to bring biometrics into AI-powered health coaching and journaling workflows.
Prerequisites
- Python 3.10 or later with uvx (part of the uv toolchain)
- An Oura Ring device and active Oura account
- A Personal Access Token from the Oura Developer Portal (cloud.ouraring.com/v2/docs)
- An MCP-compatible client such as Claude Desktop
Obtain your Oura Personal Access Token
Log in to the Oura Developer Portal at https://cloud.ouraring.com/personal-access-tokens and create a Personal Access Token. Copy the token—you will need it in the configuration step.
Install uv (if not already installed)
The server is run via uvx, which is included with uv. Install uv using the official installer.
curl -LsSf https://astral.sh/uv/install.sh | shTest the server manually
Verify the server starts correctly by running it directly with uvx and your API token set.
OURA_API_TOKEN=your_token_here uvx oura-mcp-serverAdd to Claude Desktop configuration
Add the Oura server to your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%/Claude/claude_desktop_config.json on Windows.
{
"mcpServers": {
"oura": {
"command": "uvx",
"args": ["oura-mcp-server"],
"env": {
"OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
}
}
}
}Restart Claude Desktop
Restart Claude Desktop to load the Oura server. You can then ask Claude about your sleep, readiness, and resilience data.
Oura Examples
Client configuration for Claude Desktop
Complete configuration block for the Oura MCP server. Replace YOUR_OURA_API_TOKEN with your actual Personal Access Token.
{
"mcpServers": {
"oura": {
"command": "uvx",
"args": ["oura-mcp-server"],
"env": {
"OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
}
}
}
}Prompts to try
Example prompts for querying sleep, readiness, and resilience data from your Oura Ring.
- "What's my sleep score for today?"
- "Show me my readiness data for the past week"
- "Display sleep metrics from 2024-01-01 to 2024-01-07"
- "What's my resilience score today?"
- "Compare my sleep quality this week versus last week"Troubleshooting Oura
Server fails with '401 Unauthorized' when fetching data
Your OURA_API_TOKEN is invalid or has been revoked. Go to https://cloud.ouraring.com/personal-access-tokens, create a new Personal Access Token, and update the token value in your Claude Desktop config file.
uvx command not found when starting the server
Install uv using: curl -LsSf https://astral.sh/uv/install.sh | sh — then restart your terminal and Claude Desktop. uvx is bundled with uv and should be available after installation. Verify with: which uvx
Date-range queries return empty results
Dates must be in ISO format YYYY-MM-DD (e.g., 2024-01-15). Ensure the date range falls within the period your Oura Ring was actively worn and synced. The Oura API requires the ring to have synced data to the cloud for the queried dates.
Frequently Asked Questions about Oura
What is Oura?
Oura is a Model Context Protocol (MCP) server that mcp server for oura api integration It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Oura?
Follow the installation instructions on the Oura GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Oura?
Oura works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Oura free to use?
Yes, Oura is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Oura Alternatives — Similar Analytics Servers
Looking for alternatives to Oura? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.
OpenMetadata
★ 14.0kOpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
Superset
★ 10.9kAn MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
Horizon
★ 4.4k📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达
MCP Server Chart
★ 4.1kEnables generation of 25+ types of charts and data visualizations using AntV, including bar charts, line charts, maps, mind maps, and specialized diagrams like fishbone and sankey charts. Supports both statistical charts and geographic visualizations
Muapi CLI
★ 997Official CLI for muapi.ai — generate images, videos & audio from the terminal. MCP server, 14 AI models, npm + pip installable.
Weather MCP Server
★ 907Weather Data Fetcher MCP server built with Node.js, MCP SDK, and Zod. Provides weather details like temperature and forecast for cities such as Noida and Delhi via a registered tool. Simplifies API integration, enabling structured responses for clien
Browse More Analytics MCP Servers
Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Oura in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Oura?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.