JA

jack-abyss/claude-garmin

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

21 stars 11 forks 품질 72 트렌드 18MIT

Garmin Connect data를 개인화 교육 계획, 복구 검사 및 세션 분석을위한 Claude Desktop으로 제공하는 MCP 서버

개요

- Garmin 데이터를 Claude로 가져 오는 MCP 커넥터는 훈련에 대해 채팅하고 개인화 된 계획, 복구 검사 및 세션 분석에 대해 숫자로 접지 할 수 있습니다. 설치되면 다음과 같은 것을 요청할 수 있습니다. "내 복구는 어떻게 오늘입니까? HRV 및 교육 준비를 찾고, 나는 열심히 밀어해야합니까? "Sprint triathlon 6 주 동안 4 주간 빌드를 계획하고, 현재의 수영 / 자전거 / 런 볼륨을 기본으로 사용합니다." "나는 Achilles flare-up과 내 정지 자전거를 가지고있다. 최근 로드에 기반을 둔, 내 피트니스를 죽이지 않는 복구 주를 구조." 8개의 공구를 위한 클로드 도달은 당신의 실제적인 수를 사용하여 연결관 노출 (복수, 적당, 짐, 활동, 달리는 동적인, 훈련 짐, 긴장, 개인적인 기록) 및 대답을 노출합니다. 繁體中文(简体)中文(漢字) 그것을 설정, 심지어 캐주얼 질문 같은 "나는 어떻게이 주를 복구합니까?"는 자동으로 일반적인 조언을주는 대신 실제 데이터를 잡아.

개요(AI 번역)

Garmin Connect for Claude Desktop - Garmin 데이터를 Claude로 가져 오는 MCP 커넥터는 훈련에 대해 채팅하고 개인화 된 계획을 얻을 수 있습니다, 복구 체크 및 세션 분석은 ** 번호로 접지.

설치되면 다음과 같은 것을 요청할 수 있습니다.

*"내 복구는 어떻게 오늘? HRV 및 교육 준비를 찾고, 나는 열심히 밀어해야합니까? * ·

  • “Sprint triathlon 6 주 동안 4 주간 빌드를 계획, 내 현재 수영 / 자전거 / 실행 볼륨을 기본으로.”* · “나는 Achilles flare-up을 가지고 내 정지 자전거. 최근 로드를 기반으로, 내 피트니스를 죽이지 않는 복구 주를 구조.”

8개의 공구를 위한 클로드 도달은 당신의 실제적인 수를 사용하여 연결관 노출 (복수, 적당, 짐, 활동, 달리는 동적인, 훈련 짐, 긴장, 개인적인 기록) 및 대답을 노출합니다.

└First-time setup tip — 설치 후, Claude Desktoponce로 Custom Instructions snippet을 붙여넣으십시오. 그것을 설정, 심지어 같은 캐주얼 질문 * “나는 어떻게이 주를 복구합니까?”* 자동으로 일반적인 조언을주는 대신 실제 데이터를 끌어 들일 것입니다. 그것 없이, 당신은 당신의 자료 (예를들면 *“에 근거를 둔 나의…” *, *" 나의…" *)에 각 질문을 닻을 필요로 합니다.

이 페이지는 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)

  1. Download the zip from the Releases page (or git clone) and extract it wherever you like.
  2. Double-click install.bat.
  3. 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