Unofficial Ultrahuman Ring MCP Server for AI Agent Integration

What This Is

An unofficial Model Context Protocol (MCP) server that wraps the Ultrahuman Partner API, enabling AI coding agents to directly query health data from Ultrahuman Ring and CGM devices.

Key Features & Implementation

The server provides two main tools for AI agents:

• Daily metrics: Returns a full data dump for a specified date in JSON or markdown format.
• Live value: Fetches a single metric (e.g., recovery score, sleep score, HRV) for quick status checks.

Available metrics include sleep data, HRV, resting heart rate, steps, recovery scores, glucose readings, metabolic score, and VO2 max estimates.

Setup & Requirements

The project requires:

• Python 3.10+
• Ultrahuman Partner API access (token obtained via the app's "Get help" section)
• Account email for authentication

Credentials are managed exclusively through environment variables (ULTRAHUMAN_TOKEN and ULTRAHUMAN_EMAIL), with no hardcoded values.

Compatibility & Use Cases

The MCP server works with AI setups that speak MCP, including Claude Code, Cursor, and OpenClaw. The repository includes skills that help models understand when to call the tools and how to present data for morning briefs, recovery checks, and simple analytics (weekly views, trends).

A script is also provided to generate PDF reports with charts for weekly summaries.

Project Details

• License: MIT
• Repository: https://github.com/Duzafizzl/Ultrahuman-MCP
• Status: Community project, not officially affiliated with Ultrahuman