https://github.com/tomekkorbak/oura-mcp-server

MCP server for Oura API integration
https://github.com/tomekkorbak/oura-mcp-server

mcp oura-ring

Last synced: about 2 months ago
JSON representation

MCP server for Oura API integration

• Host: GitHub
• URL: https://github.com/tomekkorbak/oura-mcp-server
• Owner: tomekkorbak
• License: mit
• Created: 2025-02-27T19:38:59.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2025-02-27T20:09:56.000Z (about 2 months ago)
• Last Synced: 2025-02-28T04:14:28.003Z (about 2 months ago)
• Topics: mcp, oura-ring
• Language: Python
• Homepage:
• Size: 19.5 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mcp-servers - tomekkorbak/oura-mcp-server - An MCP server for Oura, an app for tracking sleep (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
• awesome-mcp-servers - Oura MCP Server - MCP server for Oura API integration (Table of Contents / Other Tools and Integrations)
• awesome-mcp-servers - Oura MCP Server - MCP server for Oura API integration (Table of Contents / Other Tools and Integrations)

README

        
# Oura MCP Server

![Python Package](https://github.com/tomekkorbak/oura-mcp-server/workflows/Python%20Package/badge.svg)

[![PyPI version](https://badge.fury.io/py/oura-mcp-server.svg)](https://badge.fury.io/py/oura-mcp-server)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/release/python-3120/)

A [Model Context Protocol](https://modelcontextprotocol.io/introduction) (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](https://cloud.ouraring.com/v2/docs)

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.