Oura MCP Server

by tomekkorbak

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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables querying sleep, readiness, and resilience data from the Oura API via the Model Context Protocol (MCP), allowing natural language interaction and seamless integration with tools like Claude.

  1. Available Tools
    1. Date Range Queries
    2. Today's Data Queries
  2. Usage
    1. Claude for Desktop
  3. Example Queries
    1. Error Handling
      1. License

        Related MCP Servers

        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol server utilizing Claude AI for generating intelligent queries and offering documentation assistance based on API documentation analysis.
          Last updated -
          3
          2
          TypeScript
        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol server that enables interaction with Snapshot.org, providing tools to query Snapshot spaces, proposals, and users through natural language.
          Last updated -
          5
          2
          TypeScript
          MIT License
          • Apple
        • A
          security
          A
          license
          A
          quality
          An enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.
          Last updated -
          40
          203
          TypeScript
          MIT License
        • A
          security
          A
          license
          A
          quality
          An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling AI assistants and large language models to manage ArgoCD applications and resources through natural language interactions.
          Last updated -
          10
          6
          Python
          MIT License
          • Linux
          • Apple

        View all related MCP servers

        ID: am9tdfrzm3