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 に対応しています）

クイックコンテキスト

1 回の呼び出しで集計データを取得します：

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, maxSpeedm/s
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 対応