Garmin Mcp Unofficial

Garmin MCP

AI エージェントから Garmin の Body Battery、トレーニング準備度、睡眠、HRV、アクティビティにアクセスできます。
ローカル優先の MCP サーバー — トークンがマシンの外に出ることはありません。

⚡ Delx Wellness for Hermesを使えば、ワンコマンドでインストールできます。 npx -y delx-wellness-hermes setup — このコネクターと Delx Wellness スタック全体を、専用の Hermes プロファイルに事前設定します。

または、Claude Desktop／Cursor／ChatGPT Desktop に単体で組み込むこともできます。詳しくは、以下のインストールセクションをご覧ください。実行可能なサンプルはDelx Wellness ハブにあります。

公開されている実績： Garmin MCP は、ダウンロード数、スター数、次のアクションの優先順位とともに、Delx のオープンソース成長スナップショットで追跡されています。Garmin Connect と MCP のセットアップ時間を短縮できたら、ほかのトレーニング重視のエージェント開発者が見つけやすくなるよう、このリポジトリにスターを付けてください。

まず試すプロンプト： Use garmin_connection_status, then garmin_daily_summary, then give me a 5-line operating brief for today.

---

Garmin MCP

AI エージェントに Garmin の Body Battery、トレーニングレディネス、睡眠、HRV、アクティビティを提供します — ローカルファーストで、トークンがマシンの外に出ることはありません。

非公式プロジェクトです。 Garmin とは提携しておらず、Garmin による承認やサポートも受けていません。これは Garmin Health API の公式パートナーアクセスではありません — 非公式の Garmin Connect 個人用トークンモードを使用します。

• コネクターを 1 つインストール — npx -y garmin-mcp-unofficial setup
• 以下で実行できます Claude · Cursor · ChatGPT · Hermes · OpenClaw — 実行可能なサンプル
• ローカルファースト — Garmin トークンがマシンの外に出ることはありません（プライバシー）
• どのコネクターを使えばよいですか？ — Delx Wellness のトップページで選択してください

ローカルファーストのウェルネス MCP コネクターのレジストリである Delx Wellness の一部です。

60 秒でクイックスタート

Garmin 開発者アプリは必要ありません。setup はローカルの MCP 設定を書き込むだけで、Garmin のパスワードを求めることはありません。

npx -y garmin-mcp-unofficial setup            # writes local config
npx -y garmin-mcp-unofficial auth             # built-in login, prompts for credentials locally (no Python needed)
npx -y garmin-mcp-unofficial doctor           # verifies you're ready

HTTP（v2 ステートレス）

デフォルトは stdio です。オプションで Streamable HTTP を使用できます — セッション ID は不要で、JSON レスポンスを返し、ループバック接続のみを使用します。

npx -y garmin-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

環境変数：GARMIN_MCP_HOST、GARMIN_MCP_PORT、GARMIN_MCP_TRANSPORT=http。

または、1 回のコマンドで実行できます：npx -y garmin-mcp-unofficial setup --auth

auth は自己完結型の Node ログインを実行し、必要に応じて Garmin のメールアドレス、パスワード、MFA の入力をローカルで求めます。MCP は Garmin のパスワードを保存しません — ~/.garmin-mcp/garmin_tokens.json に、ユーザーのみがアクセスできる権限で保存されるのは Garmin Connect トークンだけです。実際のターミナル出力については認証クイックスタートの手順、全体の流れについてはdocs/quickstart.mdをご覧ください。

Garmin が HTTP 429、Cloudflare チャレンジ、または Garmin SSO の responseStatus.type が省略されたという認証メッセージを返した場合は、しばらく再試行を中止してください。ヘッドレスログインを繰り返すと、プライベートエンドポイントのスロットリングがさらに厳しくなる可能性があります。安全な復旧手順については、docs/auth.mdをご覧ください。

次に、これを MCP クライアントの設定に追加します：

{
  "mcpServers": {
    "garmin": {
      "command": "npx",
      "args": ["-y", "garmin-mcp-unofficial"]
    }
  }
}

エージェントで試す

Use garmin_connection_status to check setup, then run garmin_daily_summary.
Give me a 5-line operating brief for today.

Call garmin_weekly_summary with response_format=json. Identify my biggest
recovery/sleep/stress bottleneck and give me a next-week plan.

Use the garmin_intraday_investigation prompt for date=today, focus=stress.
Don't claim Garmin can prove anything it can't.

ツール

まず garmin_connection_status を使い、続いて garmin_daily_summary（毎日のレディネス、睡眠、負荷）または garmin_weekly_summary（スコアカード、ボトルネック、翌週の計画）を使ってください。サーバーは、日ごとのシグナル（睡眠、HRV、ストレス、Body Battery、トレーニングレディネス、心拍数、SpO2、呼吸、強度別運動時間、水分補給）、アクティビティ、プロフィール／デバイスと体重に加え、プロンプトとリソースも公開します。

すべてのツール、プロンプト、リソース、データ利用可否マトリックス、設定、Hermes のセットアップ、開発に関する注意事項については、**docs/tools.md**をご覧ください。

プライバシーとオフラインでの動作

• GARMIN_PRIVACY_MODE のデフォルトは summary です。認証モデルが非公式であるため、他の Delx Wellness コネクターよりも保守的な設定です。
• structured モードでは、正規化された別名が追加されます。秘密情報と GPS データの削除後も、上流の Garmin フィールドとネストされた DTO は完全な状態で利用できます。
• アクティビティの日付範囲では、指定されたカレンダー日付が保持され、Garmin Connect に接続する前に無効な値が拒否されます。
• Garmin Connect トークンは ~/.garmin-mcp/garmin_tokens.json に、ユーザーのみがアクセスできる権限で保存され、ツールから返されることはありません。Garmin のパスワードは保存されません — ローカルに保持されるのは有効期間の短いトークンだけです。
• MCP クライアントが Garmin の認証情報やトークンを参照することはありません。ローカルキャッシュは GARMIN_CACHE=sqlite でオプトインできます。
• これは医療上の助言ではありません。このサーバーは、診断や治療ではなく、個人用 AI ワークフロー向けにユーザーが許可したデータを公開します。

プライバシーモデルの詳細については、docs/privacy.mdをご覧ください。

エージェントのデモ全体を見る →

このようなコネクターが、実際のエンドツーエンドの判断にどう活用されるかをご覧になりたいですか？共有され、再現可能な実証例は delx-living-body にあります。

npx -y delx-living-body demo

Delx Wellness のコネクター全体から、回復、睡眠、トレーニング負荷のシグナルを組み合わせて、中心となる質問である 「今日はハードにトレーニングすべきですか？」 に答えます。

関連項目

Delx Wellness のコネクターライブラリ全体：

プロバイダー	パッケージ	リポジトリ
WHOOP	whoop-mcp-unofficial	whoop-mcp
Oura	oura-mcp-unofficial	ouramcp
Garmin	garmin-mcp-unofficial	garmin-mcp
Strava	strava-mcp-unofficial	strava-mcp
Fitbit	fitbit-mcp-unofficial	fitbitmcp
Withings	withings-mcp-unofficial	withingsmcp
Apple Health	apple-health-mcp-unofficial	apple-health-mcp
Polar	polar-mcp-unofficial	polarmcp
Nourish（栄養）	wellness-nourish	wellness-nourish

Hermes のワンコマンドセットアップ — 上記のすべてのコネクターに加え、ウェルネススキルとオンボーディングを事前設定します：delx-wellness-hermes。

関連するローカルファーストのヘルス MCP

同種のプロジェクト（Delx パッケージではありません）：Kindred / @shkyyy18 による mi-fitness-data-bridge — Xiaomi Mi Fitness 対応のローカルファーストなツールで、agent-safe-series/v1 の高密度シリーズエンベロープを共有します（期間を基準としたカバレッジ、厳密な max_points、全解像度の統計情報、シリーズツールでは GPS 情報なし）。設計ログ： #19 · 互換性に関するメモ：docs/agent-safe-series-kindred.md。

📧 お問い合わせとサポート

• 📨 [email protected] — 一般的な質問、統合のサポート、パートナーシップ
• 🐛 バグ報告／機能リクエスト — GitHub Issues
• 🐦 最新情報 — X の @delx369
• 🌐 サイト — wellness.delx.ai

ライセンス

MIT — LICENSE をご覧ください。行動規範。

免責事項

このソフトウェアは現状有姿で提供されます。医療機器ではなく、医療上のアドバイスを提供するものではありません。また、診断や治療に使用しないでください。非公式の Garmin Connect モードは、Garmin が非公開の認証方式やエンドポイントを変更すると動作しなくなる場合があります。医療に関する懸念がある場合は、必ず有資格の専門家に相談してください。

デイリーブリーフのデモ： docs/daily-brief-demo.md

スキルまたは MCP

同じパッケージに、2 つの利用方法があります。MCP は stdio／HTTP 経由でツールを登録します。スキルを使えば、クライアントに MCP がなくても CLI 経由で同じツールを実行できます。

npx -y garmin-mcp-unofficial call garmin_connection_status --json '{}'

skill/SKILL.md をエージェントのスキルディレクトリにコピーしてください。