Garmin Personal API:自分のデータを AI アシスタントで分析する
2026 年 10 月から、Garmin Connect のユーザーなら誰でも個人用 API キーを作成し、自分のアクティビティ、睡眠、HRV、Body Battery をデータとして取り出せるようになりました。ただし、キーだけでは AI チャットは何もできません。プログラムがキーをトークンに交換してデータを取得する必要があります。このページでは、API が実際に返す内容、キーの作り方、Claude・ChatGPT などのアシスタントに合ったつなぎ方をまとめます。
仕組み
- Garmin Connect自分のアカウント
- 個人用 API キー表示は 1 回だけ
- アクセストークン有効期限 24 時間
- 自分のデータJSON と FIT ファイル
- AI アシスタント読み取りのみ
キーは Garmin Connect のウェブサイトで一度作成するだけです。プログラムがキーを 24 時間有効なアクセストークンに交換し、Garmin からデータを読み込みます。健康データとアクティビティの概要は JSON、記録したアクティビティは元の FIT ファイルで届きます。書き込みは一切できません。AI アシスタントが見るのは、プログラムが取得したデータだけです。
取得できるデータ
2026 年 11 月 18 日に実際のアカウントですべてのデータを確認しました。中央の列は 1 回のリクエストで指定できる最長の期間です。それより長い期間は分けて取得します。
| データ | 1 回あたり | 内容 |
|---|---|---|
| アクティビティ | 全履歴(ページ単位) | 距離、ペース、心拍数とゾーン、トレーニング負荷とトレーニング効果、詳細とラップ、元の FIT ファイル |
| 睡眠 | 1 晩、または 1 か月分の概要 | 深い睡眠・浅い睡眠・レム睡眠・覚醒の時間、必要な睡眠時間 |
| HRV | 最長 1 年分の概要 | 夜間平均、7 日平均、ベースライン、ステータス |
| Body Battery | 1 か月(31 日) | 充電量、消費量、1 日の推移 |
| ストレスと歩数 | 28 日 | 日ごとの値 |
| 日別サマリー | 最長 1 年 | Body Battery、心拍数、ストレス、運動時間、呼吸、パルスオキシメーター、カロリー |
| VO2 max | 最長 1 年 | ランニングとサイクリングの値 |
| 心拍数、SpO2 | 1 日 | 安静時心拍数、1 日の推移、SpO2 の平均 |
| その他 | — | 体重、水分補給、心拍ゾーン、フィットネス年齢、月経周期、食事記録、プロフィール設定 |
Garmin はリクエスト数の上限を公開しておらず、規約上いつでも変更できます。
取得できないもの
次のデータは検証で「見つかりません」と返ったか、個人用キーの対象外です。
- トレーニングレディネスとトレーニングステータス
- レースタイム予測と自己ベスト
- 保存したワークアウト、トレーニングカレンダー、ギア、デバイスの一覧
- 書き込み全般:AI がワークアウトやコースをウォッチに送ることはできません。それには Garmin の Training API と Courses API が必要で、承認されたビジネスパートナーしか使えません。
- リアルタイムの更新:データはウォッチの同期後に、プログラムが要求したときだけ取得されます。
✓ 初期のガイドには「取得できない」とあるものもありますが、VO2 max は取得できます。
ステップ 1:キーを作成する
- パソコンのブラウザーで Garmin Connect を開いてサインインします。
- 設定の個人用 API キーのページを開きます(下のリンク)。
- 「キーを作成」を選び、追加の利用条件を読みます。キーは本人専用で、他人に渡すことはできません。
- 有効期間を 30 日、90 日、180 日、1 年から選びます。必要な範囲でいちばん短い期間がおすすめです。
- キーはすぐにコピーして、パスワードマネージャーに保存します。表示は 1 回だけです。なくした場合は削除して作り直します。
期限切れの約 1 週間前に Garmin からメールが届きます。キーを削除すると、そのキーと発行済みのトークンはすぐに使えなくなります。
ステップ 2:AI アシスタントにデータを読ませる
Claude も ChatGPT も、キーを直接は使えません。使っているアプリに合った方法を選んでください。
- いちばん簡単で安全
パソコンでコマンドを実行できるアシスタント
Claude Code、OpenAI Codex CLI、Cursor などは、Garmin 公式のコマンドラインクライアントを実行できます。クライアントをインストールし(Python 3.12 以降)、キーを ~/.config/garmin/connect-personal-api-key に 1 行で保存してから、アシスタントに gc-personal を使うよう頼みます。キーはファイルに残ったまま、アシスタントはクライアントが出力した JSON を読みます。
python3 -m pip install garmin-connect-personal-api-python chmod 600 ~/.config/garmin/connect-personal-api-key gc-personal sleep-summaries \ --start-date 2026-10-21 --end-date 2026-11-17 - ローカルサーバー
Claude Desktop など MCP 対応アプリ
Claude Desktop は、パソコン上で動く MCP サーバーを通して外部のデータを読みます。Garmin 公式のものはなく、Personal API を使うオープンソースのサーバーがいくつかあります。コードを確認できるものを選び、読み取り専用で使い、キーはチャットではなくそのサーバーのローカル設定に入れます。
- ファイルを添付
ChatGPT、Gemini などのウェブチャット
ウェブのチャットは、パソコン上のプログラムに接続できません。公式クライアントでデータを書き出し、JSON ファイルをチャットに添付します。ChatGPT のカスタムコネクターにはインターネット上のサーバーが必要で、キーをそのサーバーに置くことになります。
gc-personal --quiet body-battery \ --start-date 2026-10-18 --end-date 2026-11-17 \ > body-battery.json
✕ キーをチャット、スクリーンショット、共有ドキュメントに貼らない。
✓ AI に渡すのはキーではなくデータ。
外部の連携サービスと Garmin の規約
Garmin と ChatGPT や Claude をつなぐと案内するウェブサービスもあります。個人用 API キーの入力を求めるサービスに貼り付けると、キーを第三者に渡すことになります。これは Garmin の追加利用条件で認められておらず、キーが無効にされることもあります。Garmin のビジネス向けプログラムを使うサービスは、承認された独自の接続で同意を得るので、個人用キーは必要ありません。登録する前に、どちらのタイプか確認してください。
うまくいく質問の例
取得と分析を 1 つのメッセージで頼むのがコツです。例えば:
- 直近 4 週間の睡眠の概要と Body Battery を取得して。回復がいちばん悪かった夜はいつで、前日に何をしていた?
- 今年のランニングを距離、ペース、平均心拍数つきで一覧にして。同じペースで心拍数は下がってきている?
- 直近 3 か月の HRV ステータスを週ごとのトレーニング負荷と比べて。
- 最後のロング走の FIT ファイルをダウンロードして、1 km ごとのペースと心拍数を見せて。
- 直近 3 か月のストレスを 28 日ずつ取得して、いちばんきつい曜日を教えて。
データを安全に扱う
- キーは健康データへの入り口です。パスワードと同じように保管し、有効期間はできるだけ短くします。
- キーのファイルは自分だけが読めるようにし(chmod 600)、git、クラウドフォルダー、共有バックアップには入れません。
- AI が読んだデータは AI の提供元に送られます。チャットが学習に使われるかなど、データの設定を確認してください。
- 用が済んだら、個人用 API キーのページでキーを削除します。
よくある質問
Garmin Personal API は無料ですか?
はい。Garmin Connect のアカウントがあれば個人用キーを作成できます。申請も開発者アカウントも不要です。
どのウォッチで使えますか?
API が読むのはウォッチではなく Garmin Connect なので、ウォッチが同期したデータすべてが対象です。取得できる指標はモデルによって異なり、HRV ステータスや Body Battery はウォッチが記録している場合だけ表示されます。
ChatGPT や Claude が Garmin アカウントの内容を変えることはありますか?
いいえ。個人用キーは読み取り専用です。ワークアウト、コース、設定をウォッチに送ることはできません。
アクセストークンの有効期限は?
24 時間、またはキーの期限切れまでのどちらか早いほうです。リフレッシュトークンはなく、プログラムがキーで新しいトークンを取得します。Garmin 公式クライアントはこれを自動で行います。
キーをなくしました。もう一度表示できますか?
できません。キーの表示は 1 回だけです。削除して新しいキーを作成してください。
Body Battery や HRV をウォッチで直接見られますか?
はい。多くのウォッチフェイスが手首で直接表示します。カタログをお使いのウォッチで絞り込んで探せます。
関連
2026 年 11 月 18 日に実際のアカウントで Garmin の Personal API を検証しました。データの種類や上限は Garmin により変更される場合があります。
WatchFaceKit は Garmin、Anthropic、OpenAI とは関係ありません。Garmin と Garmin Connect は Garmin Ltd. またはその子会社の商標、Claude は Anthropic の商標、ChatGPT は OpenAI の商標です。