Ultrahuman (OpenClaw)

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

Setup (one-time)

You need:

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)

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

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.