Garmin Connect for Claude

Claude にあなたの Garmin データについて英語で質問できます。

"How did I sleep last night?" "Show me my runs from the last two weeks." "Am I recovered enough to train hard today?" "How much did I run last month compared to the month before?"

これはあなたの Garmin Connect アカウントを Claude Desktop アプリに接続し、Claude があなたのワークアウト、睡眠、心拍数、その他の健康データを読み取り、それらについて会話できるようにするものです。

これを使うためにコーディングの知識は必要ありません。 インストーラーがいくつかの質問をして、残りは自動で行います。

必要なもの

• Mac

• Claude Desktop アプリ

• Garmin ウォッチまたはデバイスと Garmin Connect アカウント

Related MCP server: Garmin Connect MCP Server

インストール

Mac で ターミナル アプリを開きます。（Cmd + Space を押し、Terminal と入力し、Enter キーを押します。）

次の行をコピーし、ターミナルウィンドウに貼り付けて、Enter キーを押します：

curl -fsSL https://raw.githubusercontent.com/jharkebusch/garmin-connect-mcp/main/install.sh | bash

これにより以下の処理が行われます：

1. プライベートで自己完結型の Python 環境をセットアップします（Mac の標準 Python には影響しません）

2. Garmin のメールアドレスとパスワード、および Garmin から送信されるセキュリティコードを尋ねます

3. あなたの代わりに Claude Desktop を設定します

処理が完了したら、Cmd + Q で Claude Desktop を完全に終了 し、再度開いてください。ウィンドウを閉じるだけでは不十分です。

その後は、Claude に Garmin データについて質問するだけです。

Claude にできること

健康とウェルネス

ワークアウトとアクティビティ

記録（これらは Garmin アカウントを変更します）

データを削除できるものはありません。 アクティビティ、ワークアウト、または体重測定を削除するツールはないため、誤ったリクエストでトレーニング履歴が失われることはありません。

英語での日付指定

すべてのツールは日常的な表現を理解するので、普通に話すだけで大丈夫です：

today · yesterday · last night · 3 days ago · last 7 days · this week · last month · 2026-08-18 · 2026-08-01 to 2026-08-18

プライバシーとセキュリティ

• パスワードは決して保存されません。 セットアップ中にサインインするために一度だけ使用され、その後破棄されます。

• Garmin のアクセストークンのみが保存され、~/.garminconnect に、あなたのユーザーアカウントのみが読み取り可能なファイルとして保存されます（0700 フォルダ内の 0600）。

• Garmin 以外には何も送信されません。 テレメトリ、分析、サードパーティサーバーは一切ありません。あなたのデータは Garmin からあなた自身の Mac にのみ送信され、それ以外には送信されません。

• すべてがローカルで実行されます あなたのマシン上で。

• あなたの Garmin データが Anthropic に届くのは、Claude が返信にそれを含めた場合のみであり、これは Claude に入力する他のすべての情報と同じです。

アップデート

同じインストールコマンドを再度実行してください。その場でアップデートされ、サインイン状態は維持されます。

再サインインが必要な場合

Garmin セッションは自動的に更新され、期限切れになることはほとんどありません。Claude がログインの有効期限が切れたと表示した場合は、ターミナルで以下を実行してください：

garmin-mcp-setup

ターミナルがそのコマンドを認識しない場合は、フルパスを使用してください：

~/.garmin-mcp/bin/garmin-mcp-setup

アンインストール

rm -rf ~/.garmin-mcp ~/.garminconnect ~/.local/bin/garmin-mcp-setup

次に、~/Library/Application Support/Claude/claude_desktop_config.json の mcpServers セクションから "garmin" エントリを削除します。

トラブルシューティング

Claude が Garmin ツールを認識しません。 Cmd + Q で Claude Desktop を完全に終了し、再度開いてください。ウィンドウを閉じるだけではバックグラウンドで実行されたままになります。

「Garmin アカウントがまだ接続されていません。」 ターミナルで garmin-mcp-setup を実行してください。

「リクエストが多すぎます。」 Garmin はサインイン試行をレート制限しています。約15分待ってください。

返信に数値がありません。 欠落している場合は、デバイスがそれを記録しなかったことを意味します。一部の指標（HRV、ボディバッテリー、トレーニングレディネス）は、互換性のある Garmin ウォッチを一晩着用する必要があります。ツールは値を推測する代わりに指標を省略します。

開発者向け

git clone https://github.com/jharkebusch/garmin-connect-mcp.git
cd garmin-connect-mcp
uv venv --python 3.12 && VIRTUAL_ENV=.venv uv pip install -e ".[dev]"
VIRTUAL_ENV=.venv uv run pytest

レイアウト：

• src/garmin_mcp/server.py — MCP サーバーとツール登録

• src/garmin_mcp/session.py — 認証済み Garmin クライアント、スレッドオフロード

• src/garmin_mcp/dates.py — 英語での日付解析

• src/garmin_mcp/format.py — Garmin JSON を読みやすいテキストに整形

• src/garmin_mcp/tools/ — ツール自体

• src/garmin_mcp/setup_cli.py — インタラクティブなログインと Claude 設定

2つの設計上の注意点：

• garminconnect は同期的であるため、すべての呼び出しはワーカースレッドにプッシュされます。そうしないと、1つの遅い Garmin リクエストがサーバー全体を停止させます。

• ツール呼び出し内でログインすることはできません。Garmin の二段階認証手順にはインタラクティブなプロンプトが必要だからです。セットアップはトークンファイルを書き込みます。サーバーはそれを読み取るだけです。

知っておくべき注意点

Garmin は公開 API を公開していません。これは、garminconnect ライブラリを介して、Garmin モバイルアプリが使用するのと同じインターフェースを使用しています。これは正常に動作しますが、Garmin はいつでもそのインターフェースを変更し、サードパーティ製ツールを一時的に壊す可能性があります。その場合、インストーラーを再実行すると、基盤となるライブラリが修正をリリースした時点で修正が適用されます。

このプロジェクトは Garmin Ltd. とは提携、承認、または関連していません。ご自身のアカウントとデータで使用してください。

ライセンス

MIT — LICENSE を参照してください。