Garmin Connect for Claude

Claude에게 평범한 영어로 Garmin 데이터에 대해 물어보세요.

"어젯밤에 잠은 잘 잤어?" "지난 2주간의 달리기 기록을 보여줘." "오늘 열심히 훈련할 만큼 회복됐어?" "지난달에 전달보다 얼마나 더 달렸어?"

이것은 Garmin Connect 계정을 Claude Desktop 앱에 연결하여 Claude가 운동, 수면, 심박수 및 기타 건강 데이터를 읽고 함께 이야기할 수 있게 해줍니다.

이것을 사용하기 위해 코딩 방법을 알 필요는 없습니다. 설치 프로그램이 몇 가지 질문을 하고 나머지를 처리합니다.

필요한 것

• Mac

• Claude Desktop 앱

• Garmin 시계 또는 기기를 사용하는 Garmin Connect 계정

Related MCP server: Garmin Connect MCP Server

설치

Mac에서 Terminal 앱을 엽니다. (Cmd + Space를 누르고 Terminal을 입력한 후 Enter를 누르세요.)

다음 줄을 복사하여 Terminal 창에 붙여넣고 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을 구성합니다

완료되면 Claude Desktop을 완전히 종료하고 (Cmd + Q) 다시 엽니다. 창을 닫는 것만으로는 충분하지 않습니다.

그런 다음 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 데이터는 Claude가 답변에 포함시키는 경우에만 Anthropic에 도달하며, 이는 Claude에 입력하는 다른 모든 내용과 동일합니다.

업데이트

동일한 설치 명령을 다시 실행하세요. 제자리에서 업데이트하며 로그인 상태를 유지합니다.

다시 로그인해야 하는 경우

Garmin 세션은 자동으로 갱신되며 거의 만료되지 않습니다. Claude가 로그인이 만료되었다고 말하면 Terminal에서 다음을 실행하세요:

garmin-mcp-setup

Terminal에서 해당 명령을 인식하지 못하면 전체 경로를 사용하세요:

~/.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 도구를 볼 수 없습니다. Claude Desktop을 Cmd + Q로 완전히 종료하고 다시 여세요. 창을 닫으면 백그라운드에서 실행됩니다.

"Garmin 계정이 아직 연결되지 않았습니다." Terminal에서 garmin-mcp-setup을 실행하세요.

"요청이 너무 많습니다." Garmin이 로그인 시도를 제한합니다. 약 15분 기다리세요.

답변에 숫자가 누락되었습니다. 누락은 기기가 기록하지 않았음을 의미합니다. 일부 측정항목(HRV, Body Battery, 훈련 준비도)은 호환되는 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 구성

두 가지 설계 참고 사항:

• garminconnect는 동기식이므로 모든 호출이 작업자 스레드로 푸시됩니다. 그렇지 않으면 느린 Garmin 요청 하나가 전체 서버를 중단시킵니다.

• 로그인은 도구 호출 내에서 수행될 수 없습니다. Garmin의 2단계 인증에는 대화형 프롬프트가 필요하기 때문입니다. 설정이 토큰 파일을 작성하고 서버는 이를 읽기만 합니다.

알아두면 좋은 주의사항

Garmin은 공개 API를 게시하지 않습니다. 이는 Garmin 모바일 앱이 사용하는 것과 동일한 인터페이스를 garminconnect 라이브러리를 통해 사용합니다. 잘 작동하지만 Garmin은 언제든지 해당 인터페이스를 변경하고 타사 도구를 일시적으로 중단시킬 수 있습니다. 그런 경우 기본 라이브러리가 수정 사항을 제공하면 설치 프로그램을 다시 실행하여 수정 사항을 적용합니다.

이 프로젝트는 Garmin Ltd.와 제휴, 보증 또는 연결되어 있지 않습니다. 자신의 계정과 데이터로 사용하세요.

라이선스

MIT — LICENSE 참조.