1 v0.3.1 更新于 2026-10-28

OwnMetrics MCP Server

Ask AI apps about your own Garmin data via Garmin's official Personal API. Unofficial.

适用客户端

本地客户端

Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

本地运行(pypi)

{
  "mcpServers": {
    "ownmetrics-mcp": {
      "command": "uvx",
      "args": [
        "ownmetrics-mcp"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

get_daily_overview

获取某一天的步数、距离、楼层、心率、压力、Body Battery、卡路里、强度分钟和睡眠等概览数据。

get_sleep

获取每晚的睡眠时长、深睡/浅睡/REM/清醒时间、评分、Garmin 反馈、心率和呼吸数据。

get_hrv

获取每晚的 HRV(昨夜值与周平均)、5 分钟最高值、状态和基线数据。

get_stress_and_body_battery

获取每天的压力水平、各压力区间时长及 Body Battery 的高低/充电/消耗数据。

get_heart_rate

获取某一天的心率静息值、最小值、最大值、7 天静息平均及心率区间。

list_activities

列出指定日期范围内的活动,可按类型过滤,包含时长、距离和心率信息。

get_activity

获取单个活动的配速、速度、功率、步频、训练效果与负荷及分段数据。

get_body_metrics

获取体重记录、BMI、体脂、水分、脉搏血氧和体能年龄等身体指标。

get_account_status

检查 API 密钥是否有效、是否临近到期以及各数据区域是否可访问。

training_summary

按周或月汇总训练情况:次数、时长、每周时长、晚间训练及各运动分类明细。

compare_periods

对比两个时间段的睡眠、HRV、静息心率、压力、Body Battery、步数和训练数据及其变化百分比。

recovery_correlations

分析训练与次晚睡眠和 HRV 的相关性,包含样本量和相关强度(相关性非因果)。

trend

按天、周或月查看某一指标的趋势方向及每 30 天的变化量。

weekly_review

生成本周(至今)与上周同期及前 28 天的对比周报,包含最佳/最差睡眠之夜和重点提示。