가민 MCP 서버

이 MCP(Model Context Protocol) 서버는 Garmin Connect에 연결되어 사용자의 피트니스 및 건강 데이터를 Claude와 다른 MCP 호환 클라이언트에게 공개합니다.

특징

최근 활동 목록
자세한 활동 정보를 얻으세요
건강 지표(걸음 수, 심박수, 수면)에 액세스하세요
체성분 데이터 보기

설정

새로운 환경에 필요한 패키지를 설치합니다.

지엑스피1

Garmin 자격 증명을 사용하여 프로젝트 루트에 .env 파일을 만듭니다.

GARMIN_EMAIL=your.email@example.com
GARMIN_PASSWORD=your-password

서버 실행

클로드 데스크톱과 함께

Claude Desktop에서 구성을 만듭니다.

Claude Desktop 구성 파일을 편집하세요.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

다음 서버 구성을 추가합니다.

{
  "mcpServers": {
    "garmin": {
      "command": "python", // if you created a new environment this should be "<root_folder>/.venv/bin/python"
      "args": ["<path to>/garmin_mcp/garmin_mcp_server.py"]
    }
  }
}

경로를 서버 파일의 절대 경로로 바꾸세요.

Claude Desktop을 다시 시작하세요

MCP 검사관과 함께

테스트를 위해 MCP Inspector를 사용할 수 있습니다.

npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py

사용 예

Claude에 연결되면 다음과 같은 질문을 할 수 있습니다.

"최근 활동 보기"
"어젯밤에 잠을 어떻게 잤어요?"
"어제 몇 걸음 걸었지?"
"내 최근 달리기에 대한 세부 정보를 보여줘"

보안 참고 사항

이 서버를 사용하려면 .env 파일에 Garmin Connect 자격 증명이 필요합니다. 이 파일을 안전하게 보관하고 저장소에 커밋하지 마세요.

문제 해결

로그인 문제가 발생하는 경우:

.env 파일에서 자격 증명이 올바른지 확인하세요.
Garmin Connect에 추가 확인이 필요한지 확인하세요
GarminConnect 패키지가 최신 상태인지 확인하세요

다른 문제에 대해서는 다음 위치에서 Claude Desktop 로그를 확인하세요.

macOS: ~/Library/Logs/Claude/mcp-server-garmin.log
Windows: %APPDATA%\Claude\logs\mcp-server-garmin.log

Garmin MCP Server

Integrations