가민 MCP 서버

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

특징

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

Related MCP server: Intervals.icu MCP Server

설정

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

지엑스피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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Garmin MCP Server