mcpField
G
garmin-connect

garmin-connect

github.com/eddmann其他15283 次安装23 周前更新
代码仓库

关于 garmin-connect

garmin-connect 是通过 `garmin-connect` 命令行查询和管理 Garmin Connect 数据的技能，涵盖活动、运动员、健康、训练和体重数据。

主要功能

  1. 01查询汇总的个人资料与健康信息
  2. 02列出并管理活动
  3. 03读取运动员统计数据
  4. 04查看健康与训练指标
  5. 05管理体重记录

适用场景

  1. 01查看近期活动
  2. 02检查睡眠或心率数据
  3. 03查看训练准备度与 VO2 max
  4. 04跟踪体重记录

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/eddmann/garmin-connect-cli --skill garmin-connect

安装后在 Claude Code 中输入/garmin-connect确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
Makefile
AGENTS.md
CLAUDE.md
CHANGELOG.md
.gitignore
.python-version
README.md
pyproject.toml
install-skill.sh
install.sh
.github/workflows/
release.yml
deploy-pages.yml
test.yml
site/
index.html
src/garmin_connect_cli/
__init__.py
cli.py
__main__.py
client.py
core.py
config.py
output.py
src/garmin_connect_cli/commands/
__init__.py
activities.py
training.py
auth.py
athlete.py
weight.py
context.py
health.py

详细介绍

Garmin Connect CLI 技能

通过 garmin-connect CLI 查询和管理 Garmin Connect 数据。

前提条件

  • 安装 CLI：curl -fsSL https://raw.githubusercontent.com/eddmann/garmin-connect-cli/main/install.sh | sh
  • 身份验证：garmin-connect auth login（邮箱/密码，支持 MFA）

快速上下文

一次调用即可获取汇总数据：

garmin-connect context                      # Full context: profile, stats, health, activities
garmin-connect context --activities 10      # More recent activities
garmin-connect context --focus stats,health # Specific sections only

命令

运行 garmin-connect --help 或 garmin-connect <command> --help 以查看所有选项。

活动
garmin-connect activities list [--after DATE] [--before DATE] [--limit N] [--type TYPE]
garmin-connect activities get <ID> [--details]
garmin-connect activities splits <ID>
garmin-connect activities download <ID> [--format TCX|GPX|FIT] [-o FILE]
garmin-connect activities upload <FILE>
garmin-connect activities delete <ID> [--force]
运动员
garmin-connect athlete              # Profile
garmin-connect athlete stats        # Daily statistics
garmin-connect athlete summary      # Comprehensive stats + body metrics
健康
garmin-connect health sleep [--date DATE]
garmin-connect health heart-rate [--date DATE]
garmin-connect health steps [--date DATE]
garmin-connect health stress [--date DATE]
garmin-connect health body-battery [--date DATE]
garmin-connect health rhr [--date DATE]
训练
garmin-connect training status [--date DATE]     # Productive, Peaking, etc.
garmin-connect training readiness [--date DATE]  # Readiness score (0-100)
garmin-connect training vo2max [--date DATE]
garmin-connect training hrv [--date DATE]
garmin-connect training fitness-age
体重
garmin-connect weight list [--start DATE] [--end DATE]
garmin-connect weight get [--date DATE]
garmin-connect weight log <WEIGHT_KG> [--date DATE]

数据单位

字段单位
distance米
duration, movingTime秒
averageSpeed, maxSpeed米/秒
elevation米
datesISO8601

常见模式

# Recent activities
garmin-connect activities list --limit 10

# This month's activities
garmin-connect activities list --after 2025-12-01

# Filter with jq
garmin-connect activities list | jq '[.[] | select(.activityType.typeKey=="running")]'

# Total distance
garmin-connect activities list | jq '[.[].distance] | add'

身份验证状态

garmin-connect auth status    # Check if authenticated
garmin-connect auth login     # Login with email/password (supports MFA)
garmin-connect auth logout    # Clear stored tokens

活动类型

跑步、骑行、游泳、步行、徒步、越野跑、公开水域游泳、室内骑行、虚拟骑行、力量训练、有氧运动、瑜伽、普拉提、椭圆机、室内划船、其他

退出代码

  • 0 = 成功
  • 1 = 常规错误
  • 2 = 身份验证错误（运行 garmin-connect auth login）

评论

支持 Markdown