garmin-mcp

Cloudflare Workers（無料プラン）上で動作するGarmin Connect向けリモートMCPサーバー。taxuspt/garmin_mcpの完全なTypeScript移植版です。全138ツールに加え、garmin_getパススルー（合計139）と、5つのワークアウトテンプレート/参照用MCPリソースを備えています。

モジュール：アクティビティ管理（21）、健康とウェルネス（29）、トレーニングとパフォーマンス（15）、ワークアウト＋ビルダー（19）、栄養（14）、チャレンジ/デバイス/ギア（18）、体重/ボディ/女性の健康/コース（14）、FITファイル分析（4）、ユーザープロフィール（4）、パススルー（1）。

認証：このサーバーはOAuth 2.1認可サーバーです（@cloudflare/workers-oauth-provider による）。MCPクライアントに追加すると、ブラウザページが開き、Garminのメールアドレスとパスワード（アカウントが2FAを使用している場合はMFAコードも）を入力します。WorkerはGarminのSSOウェブウィジェットログインフローをサーバーサイドで実行します。これはデータセンターIPからボットブロックされない唯一のログイン経路です。これにより、長期有効（約1年）のOAuth1トークンを取得し、認証情報を破棄して、grant内に暗号化してそのトークンのみを保存します。その後、要求に応じて connectapi.garmin.com 用の短期有効なOAuth2ベアラトークンを発行します。Garminがサーバーサイドのログインをブロックし始めた場合に備えて、「トークンを貼り付け」フォールバック（下記のローカルスクリプト経由）が詳細トグルの背後に用意されています。

デプロイ

1. npm install

2. npx wrangler kv namespace create OAUTH_KV — そのIDを wrangler.jsonc に貼り付けます

3. npx wrangler deploy

Related MCP server: Garmin Open MCP

クライアントを接続する

claude mcp add garmin --transport http https://garmin-mcp.<your-subdomain>.workers.dev/mcp

Claude Codeはブラウザで認可ページを開きます。その2つの手順に従ってください。claude.aiウェブ版：Settings → Connectors → Add custom connector で同じURLを指定します。Claude Desktopや他のstdio専用クライアントでは、mcp-remote がOAuthフローも処理します。

アクセスはOAuthのみです。rawヘッダーによる経路はありません。すべての /mcp リクエストはプロバイダーが発行したアクセストークンで保護され、アクセストークンはログインフローを完了した場合にのみ発行されます。

自分のアカウントにロックする

wrangler.jsonc の OWNER_GARMIN_IDS に、あなたのGarmin displayName（get_user_profile が返す値）を設定します。これはカンマ区切りの許可リストです。リストにないGarminアカウントでのログインは認可ステップで拒否されるため、見知らぬ人が自分の有効なGarmin認証情報を使っても、あなたのデプロイメントを利用することはできません。空のままにすると、任意のGarminアカウントを許可します。

オリジナルからの変更点（リモート/サーバーレス適応）

• download_activity_file は、ローカルディスクに書き込む代わりに、ファイル内容をインラインで返します（fitはbase64、gpx/tcx/csvはテキスト、サイズ上限あり）。set_fit_download_dir は、ドキュメント上はno-op（何もしない操作）です。

• upload_course はローカルファイルパスの代わりに gpx_content（GPX XMLテキスト）を受け取ります。

• get_activity_fit_data は session/laps/records とパワー分析（NP、VI、パワーカーブ、W/kg）をカバーします。オリジナルのDi2シフト、登坂検出、HRV分析は移植されていません。

• 無料プランのサブリクエスト予算（1回の呼び出しあたり約50回）：get_training_load_trend は45日間（以前は90日）、get_power_duration_curve は15アクティビティ（以前は20）に制限されています。get_hrv_trend はレンジエンドポイントを1回の呼び出しで使用します。目標/歩数/月経のページネーションループにも上限があります。

• ツールは事前にシリアライズされた文字列ではなくJSONオブジェクトを返します。エラーはMCPツールエラーとして表示されます。

注意事項

• GarminトークンはWorkers KV内のgrantに暗号化して保存されます。期限が切れると（約1年）、ツール呼び出しが失敗し始めます。クライアントでサーバーを再認証して、フローを再度実行してください。

• アクセストークンはベアラ資格情報です。有効なトークンを保持している人は、期限が切れるまであなたのデータにアクセスできます。したがって、セキュリティはMCPクライアントが保存したトークンを秘密に保つことに依存しています。

• ローカル開発：npm run dev を実行し、クライアントを http://localhost:8787/mcp に向けます。