jack-abyss/claude-garmin

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

21 stars 11 forks 品質 72 トレンド 18MIT

Repository Install

パーソナライズされたトレーニング計画、リカバリチェック、セッション分析のために、Garmin ConnectデータをClaude Desktopに提供するMCPサーバー

概要

— Garmin データを Claude に持ち込む MCP コネクタなので、あなたのトレーニングについてチャットし、パーソナライズされた計画、回復チェック、およびセッション分析を数に分けることができます。インストールしたら、以下のようなものを尋ねることができます。「今日の回復は? HRV とトレーニングのあり方を見て、頑張りますか? 「スプリントトライアスロンの4週間ビルドを計画します 6 週間, 私の現在のスイム/バイク/ベースラインとして実行ボリュームを使用して. 「Achillesのフレアアップと固定バイクだけを手に入れました。最近の負荷に基づいて、自分のフィットネスを殺さない回復週を構成します。クロードは、コネクタの露出(回復、フィットネス、負荷、活動、実行中のダイナミクス、トレーニング負荷、ストレス、個人記録)を8つのツールにリーチし、実際の数字を使用して回答します。 ◦ — インストール後、カスタム指示スニペットをClaudeデスクトップに貼り付けます。「今週の回復はどうすればよいですか?」というカジュアルな質問でも、一般的なアドバイスではなく、自動的に実際のデータを引き出すことができます.

概要（AI 翻訳）

Garmin Connect for Claude Desktop — Garmin データを Claude に持ち込む MCP コネクタは、トレーニングについてチャットし、real 数値に基づいたパーソナライズされた計画、回復チェック、セッション分析を得ることができます。

インストールしたら、以下のようなものを尋ねることができます。

「今日の回復はどうですか? HRV とトレーニングのあり方を見て、頑張りますか? ツイート 「スプリントトライアスロンの4週間ビルドを計画します 6 週間, 私の現在のスイム/バイク/ベースラインとしてボリュームを実行します。」 ツイート ※「Achillesのフレアアップと固定バイクのみを手に入れました。最近の負荷に基づいて、自分のフィットネスを殺さない回復週を構成します。*

クロードは、コネクタの露出(回復、フィットネス、負荷、活動、実行中のダイナミクス、トレーニング負荷、ストレス、個人記録)を8つのツールにリーチし、実際の数字を使用して回答します。

◦初回設定チップ — インストール後、カスタム指示スニペットをClaude Desktop onceに貼り付けます。設定すると、* のようなカジュアルな質問でも、今週はどのように回復しますか?* は、一般的なアドバイスを代わりに、自動的に実際のデータを引きます。それなしでは、各質問をデータ(例:*")に基づいてデータを固定する必要があります.

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

claude-garmin

Garmin Connect for Claude Desktop — an MCP connector that brings your Garmin data into Claude, so you can chat about your training and get personalized plans, recovery checks, and session analyses grounded in your real numbers.

Once installed, you can ask things like:

“How’s my recovery today? Looking at my HRV and training readiness, should I push hard?”

“Plan a 4-week build for a Sprint triathlon 6 weeks out, using my current swim/bike/run volume as the baseline.”

“I’ve got an Achilles flare-up and only my stationary bike. Based on my recent load, structure a recovery week that doesn’t kill my fitness.”

Claude reaches for the 8 tools the connector exposes (recovery, fitness, load, activities, running dynamics, training load, stress, personal records) and answers using your actual numbers.

💡 First-time setup tip — after install, paste the Custom Instructions snippet into Claude Desktop once. With it set, even casual questions like “how do I recover this week?” will automatically pull your real data instead of giving generic advice. Without it, you need to anchor each question to your data (e.g. “based on my…”, “looking at my…”).

Lifecycle — it does NOT run 24/7

The connector is not a Windows service, doesn’t start at boot, doesn’t stay resident:

Claude Desktop spawns it as a child process only when the app is open
While idle (no tool calls), footprint is ~10 MB RAM, 0% CPU — heavy imports (garminconnect, curl_cffi) are lazy and only load on the first tool call
When you close Claude Desktop, the server process exits automatically
No network ports opened: it speaks stdio with Claude Desktop only

In short: if you don’t open Claude Desktop, nothing is running.

Quick install (automated script)

Download the zip from the Releases page (or git clone) and extract it wherever you like.
Double-click install.bat.
The script will:
- Install Python 3.12 if missing (via winget)
- Install Claude Desktop if missing (via winget)
- Create the .venv virtualenv and install dependencies
- Ask for your Garmin email and password (stored only in the local .env, never sent anywhere else)
- Ask whether MFA (2FA) is enabled: if yes, it warns you to have your authenticator app ready before triggering the login prompt
- Run a one-time Garmin login (caches the OAuth token in ~/.garminconnect/, auto-refreshed for months)

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

$cfg = "$env:APPDATA\Claude\claude_desktop_config.json"
New-Item -ItemType Directory -Force -Path (Split-Path $cfg) | Out-Null

$projDir = (Get-Location).Path -replace '\\','/'
$pythonExe = "$projDir/.venv/Scripts/python.exe"
$mcpScript = "$projDir/garmin_mcp.py"

@"
{
  "mcpServers": {
    "garmin": {
      "command": "$pythonExe",
      "args": ["$mcpScript"]
    }
  }
}
"@ | Set-Content -Path $cfg -Encoding utf8

Write-Host "Config written to: $cfg"
Get-Content $cfg