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-mcp-bridge

必要なもの

• Garmin Connectに同期されているGarminデバイス

• Settings > IntegrationsでGarminを接続し、「Upload planned workouts」がオンになっている無料のintervals.icuアカウント

• Settings > Developer Settingsにある、あなたのintervals.icu APIキーとathlete id

• 無料のCloudflareアカウント

「Upload planned workouts」をオフにしている場合、以下のすべとは正常に動作しますが、ウォッチには何も届きません。最初にそれを確認してください。

セットアップ

オプション1: デプロイボタン

1. 上記のボタンをク样ックすると、CloudflareはこのリポジトリをあなたのGitHubにフォークし、KVネームスペースとDurable Objectをプロビジョンし、3つのシークレットの入力を求めます。

2. INTERVALS_API_KEY、INTERVALS_ATHLETE_ID、MCP_PASSWORDを入りします。パスワードはopenssl rand -hex 32で生成してください。

3. デプロイすると、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 deploy

Cladeに接続する

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を入れてください。ウェブで接続すれば、モバイルでも動作します。

ツール

最初に試すプロンプト

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