ultrahuman-mcp

Ultrahuman MCP Server

Ultrahuman ring owners can retrieve dated health measurements for questions in an LLM client. The ultrahuman_metrics tool brings sleep, activity, heart rate, temperature, and recovery data into an MCP workflow, including use with Claude Desktop.

Server facts

ultrahuman-mcp

Project

License
Not specified

Tech

Runtime / language
Not specified
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
20
Last commit
Data as of

Tags

  • fitness
  • sleep
  • sport
  • ultrahuman

Overview

Daily ring data is the focus of ultrahuman-mcp: its ultrahuman_metrics tool requests measurements from Ultrahuman for a date supplied in YYYY-MM-DD format. The account email comes from environment configuration rather than each tool call, so requests select a day for the configured user. Available measurements cover timestamped heart readings, skin temperature changes, HRV, and step counts. Sleep records include stages, efficiency, quality, and associated cardiovascular and temperature measurements. Recovery Index, Movement Index, and VO2 Max are also among the available data, giving ring owners several kinds of information to ask an LLM about.

The documented client workflow uses Claude Desktop, with the server handling MCP traffic over stdio. Authentication relies on an authorization token and the user's Ultrahuman email, both supplied through environment variables. Getting access involves requesting an API key and Partner ID from Ultrahuman support, then entering that partner identifier in the app. The implementation uses TypeScript, with Bun supporting development and testing and Biome handling formatting and linting.

ultrahuman-mcp setup notes

  • ultrahuman-mcp records stdio only; confirm a network transport upstream before planning remote access.
  • ultrahuman-mcp has no recorded license; confirm reuse terms in its repository.

Related MCP servers