Oura MCP Server

Oura MCP Server

Enables language models to access Oura sleep, readiness, and resilience data via MCP.

34
Stars
10
Forks
34
Watchers
5
Issues
Oura MCP Server implements the Model Context Protocol to provide language models with access to Oura API data. It allows querying of sleep, readiness, and resilience metrics for specified date ranges or for the current day. The server supports integration with tools like Claude for Desktop and handles API authentication and error scenarios gracefully. Designed for seamless access to personal health metrics through standardized protocol endpoints.

Key Features

Model Context Protocol server implementation
Access to Oura sleep data
Retrieval of readiness and resilience scores
Date range and daily queries
Integration with language models (e.g., Claude)
Error handling for authentication and API issues
Configuration using personal API tokens
Human-readable error messages
Supports Python 3.12
Open source under MIT License

Use Cases

Querying personal sleep scores via language models
Integrating Oura health data into conversational AI applications
Monitoring daily readiness and resilience metrics for wellness tracking
Building personalized health dashboards using LLMs
Automating retrieval of Oura API data through MCP endpoints
Providing NLP-based feedback on sleep and wellness trends
Supplying biometric insights to virtual health assistants
Facilitating quantified self applications for end users
Enhancing user interaction with wearable health data
Developing plugins for human-AI collaborative health monitoring

README

Oura MCP Server

Python Package PyPI version License: MIT Python 3.12

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:

json
{
    "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.

Star History

Star History Chart

Repository Owner

Repository Details

Language Python
Default Branch main
Size 20 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Topics

mcp oura-ring

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • mcp-cli

    mcp-cli

    A command-line inspector and client for the Model Context Protocol

    mcp-cli is a command-line interface tool designed to interact with Model Context Protocol (MCP) servers. It allows users to run and connect to MCP servers from various sources, inspect available tools, resources, and prompts, and execute commands non-interactively or interactively. The tool supports OAuth for various server types, making integration and automation seamless for developers working with MCP-compliant servers.

    • 391
    • MCP
    • wong2/mcp-cli
  • OpenAI MCP Server

    OpenAI MCP Server

    Bridge between Claude and OpenAI models using the MCP protocol.

    OpenAI MCP Server enables direct querying of OpenAI language models from Claude via the Model Context Protocol (MCP). It provides a configurable Python server that exposes OpenAI APIs as MCP endpoints. The server is designed for seamless integration, requiring simple configuration updates and environment variable setup. Automated testing is supported to verify connectivity and response from the OpenAI API.

    • 77
    • MCP
    • pierrebrunelle/mcp-server-openai
  • mcp

    mcp

    Universal remote MCP server connecting AI clients to productivity tools.

    WayStation MCP acts as a remote Model Context Protocol (MCP) server, enabling seamless integration between AI clients like Claude or Cursor and a wide range of productivity applications, such as Notion, Monday, Airtable, Jira, and more. It supports multiple secure connection transports and offers both general and user-specific preauthenticated endpoints. The platform emphasizes ease of integration, OAuth2-based authentication, and broad app compatibility. Users can manage their integrations through a user dashboard, simplifying complex workflow automations for AI-powered productivity.

    • 27
    • MCP
    • waystation-ai/mcp
  • MCP Server for Milvus

    MCP Server for Milvus

    Bridge Milvus vector database with AI apps using Model Context Protocol (MCP).

    MCP Server for Milvus enables seamless integration between the Milvus vector database and large language model (LLM) applications via the Model Context Protocol. It exposes Milvus functionality to external LLM-powered tools through both stdio and Server-Sent Events communication modes. The solution is compatible with MCP-enabled clients such as Claude Desktop and Cursor, supporting easy access to relevant vector data for enhanced AI workflows. Configuration is flexible through environment variables or command-line arguments.

    • 196
    • MCP
    • zilliztech/mcp-server-milvus
  • OpsLevel MCP Server

    OpsLevel MCP Server

    Read-only MCP server for integrating OpsLevel data with AI tools.

    OpsLevel MCP Server implements the Model Context Protocol to provide AI tools with a secure way to access and interact with OpsLevel account data. It supports read-only operations for a wide range of OpsLevel resources such as actions, campaigns, checks, components, documentation, domains, and more. The tool is compatible with popular environments including Claude Desktop and VS Code, enabling easy integration via configuration and API tokens. Installation options include Homebrew, Docker, and standalone binaries.

    • 8
    • MCP
    • OpsLevel/opslevel-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results