garmin-claude-mcp
garmin-claude-mcp
GarminのトレーニングデータをClaudeに接続し、Claudeが構造化されたワークアウトをあなたのウォッチにプッシュできるようにします。無料で実行できます。サブスクリプションは不要です。
Claudeはあなたの最近のアクティビティとウェルネスデータを読み取り、ワークアウトを設計して、あなたのintervals.icuカレンダーに書き込みます。Intervals.icuがそれをGarmin Connectに同期し、ウォッチに届きます。
なぜこの仕組みなのか
Garminの開発者向けAPIは個人には閉じられています。申請は企業向けに承認されますが、現在は新規申請者の受け付けを停止しています。Garminのパスワードでログインする非公式ライブラリは存在しますが、Garminはこれまでに認証フローを変更してそれらを壊したことがあります。
Intervals.icuは、プログラム停止より前から続く公式のGarmin提携をしています。それは既に、予定ワークアウトをウォッチうにプッシュすることを含む双方向の同期を提供し、文書化されたAPIと個人用キーも持ています。このためClaudeはintervals.icuと通信し、Intervals.icuがGarminと通信します。あなたのGarminパスワードがGarminの外に出ることはありません。
Related MCP server: garmin-claude-mcp
必要なもの
Garmin Connectに同期されているGarminデバイス
Settings > IntegrationsでGarminを接続し、「Upload planned workouts」がオンになっている無料のintervals.icuアカウント
Settings > Developer Settingsにある、あなたのintervals.icu APIキーとathlete id
無料のCloudflareアカウント
「Upload planned workouts」をオフにしている場合、以下のすべとは正常に動作しますが、ウォッチには何も届きません。最初にそれを確認してください。
セットアップ
オプション1: デプロイボタン
上記のボタンをク样ックすると、CloudflareはこのリポジトリをあなたのGitHubにフォークし、KVネームスペースとDurable Objectをプロビジョンし、3つのシークレットの入力を求めます。
INTERVALS_API_KEY、INTERVALS_ATHLETE_ID、MCP_PASSWORDを入りします。パスワードはopenssl rand -hex 32で生成してください。デプロイすると、
https://garmin-claude-mcp.<subdomain>.workers.devのようなURLが得られます。
オプション2: 手動
git clone https://github.com/kbaudour/garmin-claude-mcp
cd garmin-claude-mcp
npm install
npx wrangler kv namespace create OAUTH_KV
# paste the printed id into wrangler.jsonc
npx wrangler secret put INTERVALS_API_KEY
npx wrangler secret put INTERVALS_ATHLETE_ID
npx wrangler secret put MCP_PASSWORD
npm run deployCladeに接続する
claude.aiで、Settings > Connectors > Add custom connectorの移い、末尾に/mcp`を付けたワーカーURLを入と力をしてください:
https://garmin-claude-mcp.<subdomain>.workers.dev/mcpこのパスは重要です。OAuthディスカバリはドメインのルートにあるため、間違ったURLでもログインは成功しますが、その後接続は「Couldn't connect to the server.」というエラーで失敗します。その場合は、URLをその場で変るのではなく、コネクタを削除して/mcp`パス付きで追加し直して、古い登録情報を破棄してください。
パスワードページが表示されますので、あなたのMCP_PASSWORDを入れてください。ウェブで接続すれば、モバイルでも動作します。
ツール
ツール | 説明 |
| 最近のトレーニング履歴 |
| 睡眠、HRV、安静時心拍数、回復の兆候 |
| カレンダーに既にあある予定 |
| 構造化されたワークアウトを書き込み、Garminに同期する |
| 既存の予定ワークアウトを編する |
| 予定のワークアウトを削除する |
最初に試すプロンプト
Pull my wellness data for the last 7 days and my recent activities for the
last 14 days.
Based on what you see there, recovery, training load, how recent runs have
gone, design one run for tomorrow. Walk me through your reasoning before you
create it.
Then create it, and list my upcoming events so I can confirm it landed.この後、Garmin Connectアプリを開い、明日の日付を確認してください。
既知の問題と制限
Claudeの無料プランで利用可能なユーズコネクタは1つまでです。 これがその枠を使います。
パスワードページにはレート制限もCSRFトークンもありません。 64文字のランダムなパスワードの背後にあるシングルユーザーサーバーです。その用途には十分ですが、本番用の認証ではありません。
updateWorkoutとdeleteEventはテストが限られています。 読み取りツールとcreateWorkoutは、ウォッチを含めてエンドツーエンドでが確認済みです。長期的なトークン更新はテスト未です。 コネクタが失効し場合、再接続に数秒がかります。
あなたのワーカーURLを知っている人は誰でもパスワードページを見表示できます。 パスワードがなければ先に進ませんが、URL自体はシークレットではありません。
費用
月額$0。Cloudflare Workersの無料枠は1日100,000リクエストをカバーします。Intervals.icuの無料プランにはGarmin同期が含まれます。Durable Objectsは2025年4月から無料枠で利用できますので、この点を説明している古いガイドは古いています。
ラセンス
MT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Connect Intervals.icu to Claude and ChatGPT: read training, plan workouts. Training never stored.
Garmin data in Claude & ChatGPT via the Garmin Health API. OAuth sign-in, no password sharing.
Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables Claude to read recent Garmin activities and wellness/recovery data and to create, update, or delete structured workouts that sync through intervals.icu to Garmin Connect and the user's watch.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent Garmin training and wellness data and create, update, or delete structured workouts through intervals.icu, which syncs planned workouts to Garmin Connect and the user's watch.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent Garmin training and wellness data via intervals.icu and create, update, or delete structured workouts that sync to Garmin Connect and a watch.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent Garmin training activities and wellness signals (sleep, HRV, resting HR) and to create, update, or delete structured planned workouts via intervals.icu, which syncs them to Garmin Connect and onto the watch.MIT