Oura MCP Server
Provides access to Oura Ring health data, including sleep, activity, readiness, and stress metrics via the Model Context Protocol. It enables users to query their personal biometric information and daily health summaries through natural language in M
What is Oura MCP Server?
Oura MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides access to oura ring health data, including sleep, activity, readiness, and stress metrics via the model context protocol. it enables users to query their personal biometric information and da...
Provides access to Oura Ring health data, including sleep, activity, readiness, and stress metrics via the Model Context Protocol. It enables users to query their personal biometric information and daily health summaries through natural language in M
This server falls under the Data Science & ML category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides access to Oura Ring health data, including sleep, a
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx oura-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Oura MCP Server
The Oura MCP Server connects AI assistants to the Oura Ring v2 API, providing access to personal biometric data including sleep scores, readiness scores, and resilience metrics. It exposes six query tools covering both date-range queries and today's snapshots, enabling natural language health analysis like 'How did I sleep this week?' or 'What's my readiness score today?' without manually opening the Oura app.
Prerequisites
- An Oura Ring with an active account and synced data
- A personal access token from the Oura Developer Portal at https://cloud.ouraring.com/v2/docs
- Python 3.10 or higher with uv or uvx available
- Claude Desktop or another MCP-compatible client
Create an Oura personal access token
Log in to the Oura Developer Portal at https://cloud.ouraring.com/v2/docs and generate a personal access token. This token authenticates requests to the Oura Ring v2 API on your behalf.
Install uvx if not already available
The server is distributed as a Python package and runs best with uvx, which is part of the uv toolchain. Install uv if you do not have it.
curl -LsSf https://astral.sh/uv/install.sh | shTest the server manually
Run the server once with uvx to verify it starts correctly with your token before adding it to your MCP client configuration.
OURA_API_TOKEN=your_token_here uvx oura-mcp-serverAdd the server to Claude Desktop config
Edit your claude_desktop_config.json to register the Oura server. On macOS the file is at ~/Library/Application Support/Claude/claude_desktop_config.json.
{
"mcpServers": {
"oura": {
"command": "uvx",
"args": ["oura-mcp-server"],
"env": {
"OURA_API_TOKEN": "your_personal_access_token"
}
}
}
}Restart Claude Desktop and query your health data
Restart Claude Desktop to load the new configuration. You can now ask Claude about your sleep, readiness, and resilience data using natural language. All dates use ISO format YYYY-MM-DD.
Oura MCP Server Examples
Client configuration
Claude Desktop configuration for the Oura MCP server using uvx with the required OURA_API_TOKEN environment variable.
{
"mcpServers": {
"oura": {
"command": "uvx",
"args": ["oura-mcp-server"],
"env": {
"OURA_API_TOKEN": "your_personal_access_token_here"
}
}
}
}Prompts to try
Natural language prompts for querying Oura Ring biometric data through the six available tools.
- "What's my sleep score for today?"
- "Show me my readiness data for the past 7 days"
- "How was my sleep from 2024-01-01 to 2024-01-07?"
- "What's my resilience score this week compared to last week?"
- "Give me a summary of my sleep quality over the past month"Troubleshooting Oura MCP Server
Authentication error or 401 Unauthorized from the Oura API
Verify that OURA_API_TOKEN is set correctly in the env block of your config. Tokens are long alphanumeric strings from the Oura Developer Portal. Make sure you copied the full token without trailing spaces.
No data returned for date queries
The Oura API only returns data for days when your ring was worn and synced. Ensure your Oura ring has synced recent data to the cloud. Date parameters must use ISO format YYYY-MM-DD exactly.
uvx command not found
Install the uv toolchain with: curl -LsSf https://astral.sh/uv/install.sh | sh. Then restart your terminal and verify with uvx --version. Alternatively, install the package with pip install oura-mcp-server and use python -m oura_mcp_server as the command.
Frequently Asked Questions about Oura MCP Server
What is Oura MCP Server?
Oura MCP Server is a Model Context Protocol (MCP) server that provides access to oura ring health data, including sleep, activity, readiness, and stress metrics via the model context protocol. it enables users to query their personal biometric information and daily health summaries through natural language in m It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Oura MCP Server?
Follow the installation instructions on the Oura MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Oura MCP Server?
Oura MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Oura MCP Server free to use?
Yes, Oura MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Oura MCP Server Alternatives — Similar Data Science & ML Servers
Looking for alternatives to Oura MCP Server? Here are other popular data science & ml servers you can use with Claude, Cursor, and VS Code.
Ultrarag
★ 5.6kA Low-Code MCP Framework for Building Complex and Innovative RAG Pipelines
RocketRide
★ 3.1k📇 🏠 - MCP server that exposes RocketRide AI pipelines as t
Aix Db
★ 2.1kAix-DB 基于 LangChain/LangGraph 框架，结合 MCP Skills 多智能体协作架构，实现自然语言到数据洞察的端到端转换。
NeMo Data Designer
★ 1.9k🎨 NeMo Data Designer: Generate high-quality synthetic data from scratch or from seed data.
PaperBanana
★ 1.7kOpen source implementation and extension of Google Research’s PaperBanana for automated academic figures, diagrams, and research visuals, expanded to new domains like slide generation.
MiniMax
★ 1.5kBridges MiniMax AI capabilities to the Model Context Protocol, enabling AI agents to perform image understanding, text-to-image generation, and speech synthesis. It provides a standardized interface for accessing MiniMax's core tools via JSON-RPC.
Browse More Data Science & ML MCP Servers
Explore all data science & ml servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Oura MCP Server 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 MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.