Paceva for Garmin

Garmin 向け Paceva

Claude や MCP アプリに、自分の Garmin データについて質問できます。睡眠、HRV、Body Battery、ストレス、安静時心拍数、歩数、アクティビティなどを確認できます。

「昨夜の睡眠はどうでしたか？」 「今月、HRV は低下傾向ですか？」 「最近の長距離ランを 3 回分比較して」 「今の調子なら、ハーフマラソンはどれくらいのタイムで走れそうですか？」

無料のオープンソースで、ローカルで動作します。 お使いのコンピューター上で、独自の Garmin Personal API キーを使って実行します。データは Garmin からお使いのコンピューターを経由して AI アプリに送られ、他者のサーバーを経由することはありません。読み取り専用のため、Garmin Connect のデータを変更することはできません。

セットアップ

Claude Desktop：ダウンロード 1 回

1. paceva-garmin.mcpb をダウンロードして開きます。
2. Claude から Garmin キーの入力を求められたら、Garmin Connect › Personal API Key を開いて Create Key を選択し、キーをコピーして貼り付けます。
3. Paceva for Garmin をオンにします。Claude では拡張機能がオフの状態でインストールされます。
4. Claude に「昨夜の睡眠はどうでしたか？」と尋ねます。

その他のすべて：コマンド 1 つ

Node.js 20 以降が必要です。ターミナルで次を実行します。

npx github:OwenScheuer/paceva-garmin-mcp

Garmin を開き、キーをコピーするとそれを取得して Garmin で確認し、お使いの Claude Desktop、Claude Code、Cursor、Windsurf のいずれかに追加します。アプリを再起動して、質問してみましょう。

その他の MCP アプリでは、MCP サーバーに次の設定を追加します。

"garmin": { "command": "npx", "args": ["-y", "github:OwenScheuer/paceva-garmin-mcp"] }

ChatGPT はインターネット上のサーバーにしか接続できず、お使いのコンピューター上のサーバーには接続できないため、現時点ではこのサーバーを利用できません。

新しいキーを取得するには、後から npx github:OwenScheuer/paceva-garmin-mcp --new-key を実行します。動作を確認するには、npx github:OwenScheuer/paceva-garmin-mcp check を実行します。

読み取り可能なデータ

ツール	AI に提供する情報
get_daily_overview	1 日の概要：サマリー、睡眠、HRV、Body Battery
get_daily_summaries	日ごとの歩数、カロリー、安静時心拍数、ストレス、強度の高い運動時間
get_sleep	1 晩の詳細、または指定期間の毎晩のサマリー
get_hrv	夜間の HRV、ベースライン、ステータス
get_body_battery	充電量、消費量、最高値、最低値
get_stress · get_steps · get_heart_rate · get_spo2	日ごとのストレス、歩数、心拍数、Pulse Ox
get_training_log	指定期間（最長 1 年）のすべてのアクティビティと、距離、時間、速度、心拍数、パワー、TSS、最速スプリット、ゾーン別の時間など、Garmin の主なフィールド
list_activities · get_activity	アクティビティ一覧と、個別アクティビティの全情報
get_profile	プロフィール設定と心拍ゾーン
get_weight · get_fitness_age · get_hydration · get_food_log · get_menstrual_cycle	Garmin Personal API が提供するその他の情報

Garmin のデータのみを使用します。 スコア、モデル、アドバイスは追加しません。すべての数値は Garmin のデータで、Garmin 独自のフィールド名と単位が使われます。「今の調子なら 10K をどれくらいのタイムで走れそう？」と尋ねた場合、その予測はデータをもとに AI が独自に行います。

1 回の呼び出しで取得できる期間は最長 92 日です（トレーニングログは 1 年）。1 分ごとの時系列データ（1 日を通した心拍数や睡眠ステージなど）は、AI が全データを求めない限り、件数、最小値、最大値、平均値として返されます。

Garmin の Personal API にはトレーニングレディネス、トレーニングステータス、リカバリータイムが含まれないため、このツールでも確認できません。

キーとプライバシー

• キーは ~/.config/garmin/connect-personal-api-key に保存されます。ここは Garmin の公式ツールも使用する場所で、あなたのみが読み取り可能です。代わりに GARMIN_PERSONAL_API_KEY を設定することもできます。
• Garmin が発行する短期間有効なアクセストークンは ~/.config/paceva-garmin/token.json にキャッシュされます。こちらもあなたのみが読み取り可能です。
• AI アプリが読み取るデータは、チャットの一部として、そのアプリのプロバイダー（Anthropic や OpenAI など）に送信され、各プロバイダーのプライバシー規約が適用されます。
• アクセスを取り消すには、Garmin Connect でキーを削除してください。

Garmin の Personal API は、ご自身のデータを対象としています。各自が自分のキーを使用してください。他の人のキーを収集するサービスは構築しないでください。

トラブルシューティング

• 「Garmin が Personal API キーを受け付けません」：期限切れ、または削除されています。npx github:OwenScheuer/paceva-garmin-mcp --new-key を実行してください。（Claude Desktop 拡張機能の場合は、Settings › Extensions でキーを更新してください。）
• 「Garmin Personal API キーが見つかりません」：ターミナルで npx github:OwenScheuer/paceva-garmin-mcp を実行してください。
• 「Garmin がリクエストをレート制限しています」：1 分待ってから、もう一度お試しください。

開発

npm install
npm test
npm run build
./scripts/pack-mcpb.sh   # builds paceva-garmin.mcpb

Garmin とは提携しておらず、Garmin の承認も受けていません。Garmin および Garmin Connect は、Garmin Ltd. またはその子会社の商標です。

MIT ライセンス。制作： Paceva。