OM

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 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

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 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

Repository: github.com
Hosted: No
Global: No
Official: No

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