Oura MCP server
Created 7 months ago
A Model Context Protocol (MCP) server that provides access to the Oura API.
development
documentation
public
What is Oura MCP server?
MCP server for Oura API to retrieve one's sleep data
Documentation
Oura MCP Server
Available Tools# Date Range Queries
get_sleep_data(start_date: str, end_date: str): Get sleep data for a specific date rangeget_readiness_data(start_date: str, end_date: str): Get readiness data for a specific date rangeget_resilience_data(start_date: str, end_date: str): Get resilience data for a specific date range
Today's Data Queries
get_today_sleep_data(): Get sleep data for todayget_today_readiness_data(): Get readiness data for todayget_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:
- Going to the Oura Developer Portal
- Creating a Personal Access Token
Claude for Desktop
Update your claude_desktop_config.json 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
Server Config
{
"mcpServers": {
"oura-mcp-server-server": {
"command": "npx",
"args": [
"oura-mcp-server"
]
}
}
}
Links & Status
Project Info
Hosted
Featured
Created At:
Jul 17, 2025
Updated At:
Aug 07, 2025
Author:
Tomek Korbak
Category:
community
License:
MIT License
Tags:
development
documentation
public