🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Ultrahuman (OpenClaw)

by @devpranoy

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.

Versionv0.1.2
Downloads2,442
Installs1
Stars⭐ 2
TERMINAL
clawhub install ultrahuman-openclaw

πŸ“– About This Skill


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.

    πŸ’‘ Examples

    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