garmin-mcp

あなたの Garmin データと会話する。 読み取り専用の MCP サーバーで、Claude と ChatGPT があなたのトレーニングに関する質問に答えられるようにします。アクティビティ、睡眠、HRV、Body Battery、トレーニングステータス、チャレンジのリーダーボード、そして他の Garmin MCP サーバーとは異なり、あなたのウォッチが書き込んだ オリジナルの FIT ファイル（Connect-IQ センサーチャンネル: Stryd、Moxy/SmO2、CORE を含む）にも対応します。

You:  How did my last long run compare to the same route in June?
You:  Why is my training readiness so low this morning?
You:  Where do I stand in the running challenge, and who is ahead of me?
You:  Did my Stryd actually record power on Tuesday's session?

Garmin Connect に書き込むことは一切ありません。すべてのツールは読み取り専用です。

3つの利用方法

1. ゲストアクセス - インフラが一切不要な唯一の方法です。招待リンクを開き、アカウントを作成し、Garmin を接続すれば完了です。ルート3と同様に、ブラウザの claude.ai と ChatGPT で動作します。ルート2は、そのどちらもコンピューター上でプログラムを起動できないため、使えません。

ゲストアクセスはまだ一般公開されていません。 現在は個人的な招待によって、少数のテスターとともに運営されています。招待をリクエストする一般向けの方法が計画されています。それまでは、ルート2と3を今日から利用できます。

2. ローカル - データはマシンの外に出ません。アカウントもサーバーも不要です。AI クライアントが必要になったときだけプロセスを起動します。そもそも Claude Desktop や Claude Code を使っていて、すべてをローカルに保ちたい場合に最適です。

3. 自分専用サーバー - ゲストアクセスの背後にあるのと同じソフトウェアです。自分のために実行し、好きな人を招待し、データを所有できます。docs/self-hosting.md を参照してください。

クイックスタート（ローカル）

uv tool install git+https://github.com/mskerwiderski/mcp-garmin

garmin-mcp login

ログインでは、Garmin のメールアドレス、パスワード、そして使用している場合は多要素認証コードが求められます。保存されるのは Garmin の OAuth トークンだけで、~/.garmin-mcp/tokens.json にモード 0600 で保存されます。パスワードがどこかに書き込まれることは決してありません。

次に、サーバーをクライアントに登録します:

claude mcp add garmin -- garmin-mcp serve

新しいセッションを開始して、何か質問してみてください。Claude Desktop を含む完全なチュートリアル: docs/install-claude.md

ドキュメント

答えられること

アクティビティ - スポーツと日付で一覧表示・フィルタリング、Garmin 自身による1つのアクティビティのサマリー、そしてデバイスが記録したのと同じアクティビティを FIT ファイルから直接取得できます。ファイル内の任意のチャンネルの時系列、プールスイミングの詳細を1レングス単位まで、さらに実際にデータを配信した Connect-IQ センサーも確認できます。

ヘルス - 1回の呼び出しで、歩数、安静時心拍数、ストレス、Body Battery、スコア付きの睡眠フェーズ、HRV ステータス、トレーニングレディネスを取得できます。さらに、負荷フォーカスと VO2max を備えたトレーニングステータス、体組成、血圧を期間指定で取得できます。

トレンドとプラン - 1日ごとではなく、1回の呼び出しで1か月分の歩数、Body Battery、VO2max を取得できます。Garmin のスケジュール面もカバーし、トレーニングプランのワークアウトやレースを扱えるため、「計画されていたこと」と「実際に起きたこと」を比較できます。

自分の立ち位置 - 5k からマラソンまでのレース予想、フィットネス年齢、持久力とヒルスコア、生涯累計、そしてそれぞれを達成したアクティビティ付きの自己ベストを確認できます。

コンテキスト - 閾値と心拍数ゾーン、アクティビティとその背後にあるキロメートル・時間・日数を備えたギア、そして友人と競うソーシャルチャレンジ（現在進行中のものを含む）を確認できます。

全リストとパラメータについては docs/tools.md を参照してください。

なぜログインが自分のマシンで行われるのか

Garmin の SSO は Cloudflare の背後にあり、Cloudflare は 2026年3月以降、データセンターの IP からの新しいログインに対して 429 または 403 を返します。そのため、garmin-mcp login はあなたの手元で実行されます。生成された OAuth1 トークンは約1年間有効で、connectapi.garmin.com に対してアクセストークンを発行します。したがって、ログイン後に sso.garmin.com に再び触れることはありません。

ホスト型サーバーは2つの方法を提供します。ログインフォーム（パスワードは一度だけ使用され、保存されません）と、garmin-mcp export からトークンブロブを貼り付ける方法です。後者は、Garmin がサーバーのアドレスをブロックした場合の入り口になります。

参考情報

これは Garmin の内部 Connect API を使用しています。すべてのコミュニティツールが使っているのと同じものです。個人向けの公式 API は存在せず、Garmin の Health API はパートナープログラムです。これは自分のアカウントに使用し、ホスト型インスタンスは実際に知っている人だけに限定してください。1つのサーバー上のすべてのアカウントは、Garmin に対して1つのアドレスを共有することになります。

応答は意図的に小さくしています。Garmin はアクティビティごとに数百のフィールド、数千ポイントの時系列を返します。これらはすべて、モデルが実際に使えるものへと縮約され、ストリームはチャンネルごとに min/max/avg でリサンプリングされます。これは見た目だけの問題ではありません。生のペイロードは、会話に必要なコンテキストウィンドウを消費してしまうからです。

開発

python3.12 -m venv .venv && .venv/bin/pip install -e ".[dev]"

.venv/bin/pytest

テストは103件、ネットワークアクセスは不要です。Garmin API と FIT ファイルはスタブ化または合成されています。各部分がどのように組み合わさるかについては docs/architecture.md を参照してください。

ライセンス

MIT。LICENSE を参照してください。