
jack-abyss/claude-garmin
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
MCP-сервер, который переносит данные Garmin Connect в Claude Desktop для персонализированных планов обучения, проверок восстановления и анализа сеансов
Обзор
Разъем MCP, который переносит ваши данные Garmin в Claude, чтобы вы могли общаться о своем обучении и получать персонализированные планы, проверки восстановления и анализ сеансов, основанные на ваших номерах. После установки вы можете спросить такие вещи, как: Как мое выздоровление сегодня? Глядя на мою HRV и готовность к тренировкам, я должен сильно давить? Запланируйте 4-недельную сборку для триатлона Sprint на 6 недель, используя мой текущий объем плавания / велосипеда / бега в качестве базовой линии. "У меня вспышка Ахиллеса и только мой неподвижный велосипед. Основываясь на моей недавней нагрузке, структурируйте неделю восстановления, которая не убивает мою физическую форму». Клод обращается к 8 инструментам, которые разъем раскрывает (восстановление, фитнес, нагрузка, действия, динамика бега, тренировочная нагрузка, стресс, личные записи) и ответы, используя ваши фактические номера. После установки вставьте фрагмент пользовательских инструкций в Claude Desktop. Даже случайные вопросы, такие как «Как мне восстановиться на этой неделе?», автоматически вытаскивают ваши реальные данные вместо того, чтобы давать общие советы.
Обзор (машинный перевод)
Garmin Connect for Claude Desktop — разъем MCP, который переносит ваши данные Garmin в Claude, чтобы вы могли общаться о своем обучении и получать персонализированные планы, проверки восстановления и анализ сеансов, основанные на ваших ** реальных ** номерах.
После установки вы можете спросить такие вещи, как:
«Как мое выздоровление сегодня?» Глядя на мою HRV и готовность к тренировкам, я должен сильно давить?
Запланируйте 4-недельную сборку для триатлона Sprint на 6 недель, используя мой текущий объем плавания / велосипеда / бега в качестве базовой линии.
У меня вспышка Ахилла и только мой стационарный велосипед. Основываясь на моей недавней нагрузке, структурируйте неделю восстановления, которая не убивает мою физическую форму.
Клод обращается к 8 инструментам, которые разъем раскрывает (восстановление, фитнес, нагрузка, действия, динамика бега, тренировочная нагрузка, стресс, личные записи) и ответы, используя ваши фактические номера.
. * * Наконечник настройки в первый раз * * - после установки вставьте фрагмент пользовательских инструкций в Claude Desktop * * * * *. Даже случайные вопросы, такие как «Как мне восстановиться на этой неделе?», автоматически вытаскивают ваши реальные данные вместо того, чтобы давать общие советы. Без этого вам нужно привязать каждый вопрос к вашим данным (например, «на основе моего…», «смотря на моего…»).
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
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
.venvvirtualenv 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)
Установка
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