ultrahuman-openclaw

name	ultrahuman-openclaw
description	Fetch and summarize Ultrahuman Ring/CGM metrics inside OpenClaw using the Ultrahuman MCP server (via mcporter). Use when the user asks about Ultrahuman data such as sleep score, total sleep, sleep stages, HR/HRV/RHR, steps, recovery index, movement index, VO2 max, or wants a daily/weekly Ultrahuman summary.

Ultrahuman (OpenClaw)

Fetch Ultrahuman metrics via Ultrahuman MCP and mcporter, then summarize them.

Setup (one-time)

You need:

1. Ultrahuman Developer/Partner credentials

You need a personal auth token from Ultrahuman Developer Portal:

• https://vision.ultrahuman.com/developer

Then set:

• ULTRAHUMAN_USER_EMAIL
• ULTRAHUMAN_AUTH_TOKEN (your personal token)
• (Also set your Partner ID in the Ultrahuman app, if provided/required)

2. Ultrahuman MCP server

Repository:

• https://github.com/Monasterolo21/Ultrahuman-MCP

Build it (example):

• bun install && bun run build
• You should end up with an entrypoint like: dist/main.js

3. mcporter config that defines an MCP server named ultrahuman

Example config/mcporter.json (adjust path to your built main.js):

{
  "mcpServers": {
    "ultrahuman": {
      "transport": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/Ultrahuman-MCP/dist/main.js"],
      "env": {
        "ULTRAHUMAN_AUTH_TOKEN": "${ULTRAHUMAN_AUTH_TOKEN}",
        "ULTRAHUMAN_USER_EMAIL": "${ULTRAHUMAN_USER_EMAIL}"
      }
    }
  }
}

Quick start

Daily summary (recommended)

From your OpenClaw workspace (so ./config/mcporter.json is found):

cd /path/to/your/openclaw/workspace
python3 skills/local/ultrahuman-openclaw/scripts/ultrahuman_summary.py --yesterday

Specific date:

python3 skills/local/ultrahuman-openclaw/scripts/ultrahuman_summary.py --date YYYY-MM-DD

If your mcporter config isn’t at ./config/mcporter.json, pass it explicitly:

python3 skills/local/ultrahuman-openclaw/scripts/ultrahuman_summary.py \
  --date YYYY-MM-DD \
  --mcporter-config /path/to/mcporter.json

Raw JSON

mcporter --config /path/to/mcporter.json \
  call ultrahuman.ultrahuman_metrics date=YYYY-MM-DD --output json

What to report (default)

Keep summaries short unless asked:

• Sleep score + total sleep + efficiency + restorative sleep + deep/REM
• Steps total
• Recovery index, movement index, active minutes
• VO2 max, sleep HRV, RHR

If sleep score/total sleep are in a "Needs attention" state, call it out explicitly.