Ultrahuman Mcp

Name: Ultrahuman Mcp
Author: Monasterolo21

@Monasterolo21

Ultrahuman Mcp について

A simple MCP server using the Ultrahuman API to retrieve fitness data from your ring and query information about it from your favorite LLM. You can get info about your sleep, breath, hearth rate, steps and many more info.

#ultrahuman #fitness #sport #sleep

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

Monasterolo21

投稿者

Samuele Monasterolo

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "ultrahuman": {
      "command": "npx",
      "args": [
        "-y",
        "ultrahuman-mcp"
      ],
      "env": {
        "ULTRAHUMAN_AUTH_TOKEN": "your_token_here",
        "ULTRAHUMAN_USER_EMAIL": "[email protected]"
      }
    }
  }
}

ツール

Fetch health and fitness metrics from Ultrahuman API for a specific date. The user email is configured via environment variable, so you only need to specify the date to retrieve health data including heart rate, sleep, steps, temperature, and other biometric measurements.

概要

What is Ultrahuman Mcp?

An MCP server that fetches health and fitness metrics from the Ultrahuman API for integration with AI assistants like Claude Desktop. Designed for developers who want to query their Ultrahuman ring data programmatically.

How to use Ultrahuman Mcp?

Install dependencies with bun install, build with bun run build, then set environment variables ULTRAHUMAN_AUTH_TOKEN and ULTRAHUMAN_USER_EMAIL. Add the server to Claude Desktop by editing its config file—the command is node dist/main.js with the required env vars. Invoke the ultrahuman_metrics tool with a date parameter (YYYY-MM-DD) to retrieve health data.

Key features of Ultrahuman Mcp

Fetch comprehensive health metrics from the Ultrahuman API
Heart rate, sleep, steps, temperature, and HRV monitoring
Built with TypeScript for type safety
Bun for fast testing and development
Biome for linting and formatting
Clean, maintainable project structure

Use cases of Ultrahuman Mcp

Query daily sleep analysis including stages and quality metrics
Retrieve continuous heart rate and HRV data for a specific date
Monitor skin temperature and movement (steps) trends
Fetch recovery index and VO2 max for fitness tracking

FAQ from Ultrahuman Mcp

How do I get the required Ultrahuman API credentials?

Open the Ultrahuman app, go to Profile > Settings to find your email. Then request an API key and Partner ID from [email protected] or the in-app chat, including your email. Enter the Partner ID in the Ultrahuman app settings.

What health data can I fetch with the `ultrahuman_metrics` tool?

Heart rate, skin temperature, HRV, steps, sleep data (stages, efficiency, quality, HR, HRV, temperature during sleep), recovery index, movement index, and VO2 max.

How do I configure the server for Claude Desktop?

Add the server to your Claude Desktop config file with "command": "node", "args": ["/path/to/dist/main.js"], and environment variables ULTRAHUMAN_AUTH_TOKEN and ULTRAHUMAN_USER_EMAIL.

What runtime and tools are required to run this server?

You need Node.js to execute the built JavaScript. Bun is used for development and building, and TypeScript with Biome for type safety and linting.

Does the server store any data or connect to any external service besides the Ultrahuman API?

No. The server fetches data on demand from the Ultrahuman API at https://partner.ultrahuman.com/api/v1. It does not store any data locally. Authentication uses tokens passed via environment variables.