Oura MCP server

Oura MCP server

MCP server for Oura API to retrieve one's sleep data

34
Stars
12
Forks
0
Releases

Overview

The Oura MCP Server is a Model Context Protocol server that exposes the Oura API to language models and other MCP clients. It enables querying sleep, readiness, and resilience data from the Oura API via simple MCP tools. The server provides date range queries (get_sleep_data, get_readiness_data, get_resilience_data) that accept start_date and end_date in ISO format (YYYY-MM-DD), as well as today-specific queries (get_today_sleep_data, get_today_readiness_data, get_today_resilience_data). To use it, you must supply an Oura API Personal Access Token, typically via the OURA_API_TOKEN environment variable. The README also demonstrates Claude Desktop integration, showing how to configure Claude to invoke the server. Error handling is designed to produce human-readable messages for common issues such as invalid date formats, authentication errors, and network problems. Dates must be provided in ISO format. The project emphasizes easy integration for AI assistants and language models to access personal wearables data safely when authenticated.

Details

Owner
tomekkorbak
Language
Python
License
MIT License
Updated
2025-12-07

Features

Date Range Sleep Data Query

Retrieve sleep data for a specific date range using get_sleep_data(start_date, end_date).

Date Range Readiness Data Query

Retrieve readiness data for a specific date range using get_readiness_data(start_date, end_date).

Date Range Resilience Data Query

Retrieve resilience data for a specific date range using get_resilience_data(start_date, end_date).

Today Sleep Data Query

Get today's sleep data with get_today_sleep_data().

Today Readiness Data Query

Get today's readiness data with get_today_readiness_data().

Today Resilience Data Query

Get today's resilience data with get_today_resilience_data().

Token-based Authentication

Requires an Oura API token (environment variable OURA_API_TOKEN) for API access.

ISO Date Format Support

Dates must be provided in ISO format (YYYY-MM-DD).

Audience

Language modelsQuery sleep, readiness, and resilience data from Oura API via MCP server.
DevelopersIntegrate Oura data access into MCP-enabled apps and assistants for user queries.

Tags

OuraMCPsleepreadinessresilienceAPIdate rangetoday datatokenClaude