TG

taxuspt/garmin_mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

1431 stars 449 forks 品質 87 トレンド 50MIT

GarminデータにアクセスするためのMCPサーバー

概要

このモデルコンテキストプロトコル(MCP)サーバーはGarmin Connectに接続し、Claudeや他のMCP互換クライアントにフィットネスや健康データを公開します。 GarminのAPIは素晴らしいpython-garminconnectライブラリを通じてアクセスできます。 - ページ付きで最近の活動を一覧化 - 詳細な活動情報取得 - アクティビティ名、種類、説明/メモ、イベントタイプ、知覚努力(RPE)、フィールを編集 - 健康指標(歩数、心拍数、睡眠、ストレス、呼吸)アクセス - 体組成データの閲覧 - トレーニング状況と準備状況の追跡 - サイクリングFTPおよび乳酸閾値指標のアクセス - 装備と装備の管理 - ワークアウトとトレーニングプランの詳細なチェック - 繰り返しグループやスイムペース目標を含む詳細なワークアウトステップ構造の検査 - 週ごとの健康集計(ステップ数、ストレス、強度分数)- 高度なサイクリング分析:パワーゾーン、FITファイル分析、DI2電子シフトインテリジェンス - トレーニング負荷トレンド(CTL/ATL/TSB)、HRV トレンド、VO2 maxトレンド、呼吸率トレンド-...

概要(AI 翻訳)

このモデルコンテキストプロトコル(MCP)サーバーはGarmin Connectに接続し、Claudeや他のMCP互換クライアントにフィットネスや健康データを公開します。

GarminのAPIは素晴らしいpython-garminconnectライブラリを通じてアクセスできます。

特徴

  • ページ付き支援による最近の活動一覧
  • 詳細な活動情報の取得
  • アクティビティの編集:名前、タイプ、説明/メモ、イベントタイプ、知覚された努力(RPE)、フィール、筋力エクササイズセット
  • 健康指標(歩数、心拍数、睡眠、ストレス、呼吸)へのアクセス
  • 体組成データの閲覧
  • 訓練状況と準備状況の追跡
  • 循環FTPおよび乳酸閾値指標へのアクセス
  • 機材や装備の管理、[[T0]から返送されたフリーテキストノートを含む)
  • ワークアウトやトレーニングプランへのアクセス
  • 繰り返しグループやスイムペース目標を含む詳細なワークアウトステップ構造の検査
  • 週ごとの健康集計(歩数、ストレス、強度分)
  • 高度なサイクリング分析:パワーゾーン、FITファイル解析、DI2電子シフトインテリジェンス
  • トレーニング負荷の傾向(CTL/ATL/TSB)、HRV(心率変異体)傾向、VO2 maxの傾向、呼吸率の傾向
  • パワーデュレーションカーブ、VAMによる上昇検出、心拍ドリフト(有酸素デカップリング)、W/kg計算

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Garmin MCP Server

This Model Context Protocol (MCP) server connects to Garmin Connect and exposes your fitness and health data to Claude and other MCP-compatible clients.

Garmin’s API is accessed via the awesome python-garminconnect library.

Features

  • List recent activities with pagination support
  • Get detailed activity information
  • Edit activities: name, type, description/notes, event type, perceived effort (RPE), feel, and strength exercise sets
  • Access health metrics (steps, heart rate, sleep, stress, respiration)
  • View body composition data
  • Track training status and readiness
  • Access cycling FTP and lactate threshold metrics
  • Manage gear and equipment, including free-text notes returned by get_gear
  • Access workouts and training plans
  • Inspect detailed workout step structures, including repeat groups and swim pace targets
  • Weekly health aggregates (steps, stress, intensity minutes)
  • Advanced cycling analytics: power zones, FIT file analysis, DI2 electronic shift intelligence
  • Training load trend (CTL/ATL/TSB), HRV trend, VO2 max trend, respiration rate trend
  • Power Duration Curve, climb detection with VAM, cardiac drift (aerobic decoupling), W/kg calculations

Tool Coverage

This MCP server implements 110+ tools covering ~90% of the python-garminconnect library (v0.3.2):

  • ✅ Activity Management (21 tools) - includes write tools for type, description, event type, perceived effort, feel, and exercise sets
  • ✅ Health & Wellness (34 tools) - includes custom lightweight summary tools
  • ✅ Training & Performance (13 tools) - includes CTL/ATL/TSB, HRV, VO2 max, and respiration trends
  • ✅ Workouts (8 tools)
  • ✅ Devices (8 tools) - includes sending a workout to a device
  • ✅ Gear Management (5 tools)
  • ✅ Weight Tracking (5 tools)
  • ✅ Challenges & Badges (10 tools)
  • ✅ Nutrition (9 tools) - food logs, meals, custom foods, food logging, and multi-day intake summaries
  • ✅ Women’s Health (3 tools)
  • ✅ User Profile (3 tools)
  • ✅ High-Level Workout Builders (4 tools) - create and schedule workouts without writing JSON
  • ✅ Courses (5 tools) - list / get details / upload GPX as course / download GPX / delete course
  • ✅ Activity Analysis (2 tools) - FIT file parsing, Power Duration Curve; requires power meter and/or Di2
  • ✅ Activity File Downloads (2 tools) - download activity files in FIT, GPX, TCX, or CSV format

Note: Activity Analysis tools require a compatible power meter (e.g., Garmin Rally, Favero Assioma, PowerTap P1) and/or Shimano Di2 / SRAM eTap electronic shifting. The fitparse dependency is installed automatically.

Gear Notes

Each item in the gear array returned by get_gear includes a notes field

GitHub で README 全文を見る

インストール

uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "garmin": { "command": "uvx", "args": [ "--python", "3.12", "--from", "git+https://github.com/Taxuspt/garmin_mcp", "garmin-mcp" ] } } }