NG

nicolasvegam/garmin-connect-mcp

Developer tools

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

190 stars 97 forks 품질 77 트렌드 38

nicolasvegam/garmin-connect-mcp는 https://github.com/nicolasvegam/garmin-connect-mcp.에서 임포트된 MCP 서버 후보입니다.

개요

nicolasvegam/garmin-connect-mcp는 https://github.com/nicolasvegam/garmin-connect-mcp.에서 임포트된 MCP 서버 후보입니다.

개요(AI 번역)

가민 커넥트용 MCP 서버입니다. Claude Code, Claude Desktop, 커서, 윈드서프 또는 모든 MCP 클라이언트에서 피트니스, 건강, 트레이닝 데이터를 확인할 수 있습니다.

61가지 도구가 7개 카테고리에 걸쳐 있습니다: 활동, 일상 건강, 트렌드, 수면, 체성분, 수행/훈련, 프로필/기기.

API 엔드포인트와 인증 흐름은 cyberjunky의 python-garminconnect를 기반으로 합니다.

요구 사항

  • Node.js 20+
  • 가민 커넥트 계정 (이메일 및 비밀번호)

설치

클로드 코드

클로드 데스크탑

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows)에 추가:

커서

프로젝트 루트에 .cursor/mcp.json를 추가하세요:

윈드서핑

~/.codeium/windsurf/mcp_config.json에 추가:

어떤 MCP 클라이언트든

서버 실행 변수를 적용하세요:

서버는 모델 컨텍스트 프로토콜을 사용하여 stdio를 통해 통신합니다.

사용 가능한 도구

활동 (12 도구)

도구 설명
get_activities 최근 활동 목록 및 페이지 포함
get_activities_by_date 날짜 범위 내의 검색 활동
get_last_activity 최신 활동 보기

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

README

원문 README의 일부입니다. 원문 보기.

garmin-connect-mcp

MCP server for Garmin Connect. Access your fitness, health, and training data from Claude Code, Claude Desktop, Cursor, Windsurf, or any MCP client.

61 tools across 7 categories: activities, daily health, trends, sleep, body composition, performance/training, and profile/devices.

API endpoints and authentication flow based on python-garminconnect by cyberjunky.

Requirements

  • Node.js 20+
  • A Garmin Connect account (email and password)

Installation

Claude Code

claude mcp add garmin -e [email protected] -e GARMIN_PASSWORD=yourpass -- npx -y @nicolasvegam/garmin-connect-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "garmin": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "[email protected]",
        "GARMIN_PASSWORD": "yourpass"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "garmin": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "[email protected]",
        "GARMIN_PASSWORD": "yourpass"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "garmin": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "[email protected]",
        "GARMIN_PASSWORD": "yourpass"
      }
    }
  }
}

Any MCP Client

Run the server with environment variables:

[email protected] GARMIN_PASSWORD=yourpass npx -y @nicolasvegam/garmin-connect-mcp

The server communicates over stdio using the Model Context Protocol.

Available Tools

Activities (12 tools)

Tool Description
get_activities List recent activities with pagination
get_activities_by_date Search activities within a date range
get_last_activity Get the most recent activity
count_activities Get total number of activities
get_activity Summary data for a specific activity
get_activity_details Detailed metrics: HR, pace, elevation time series
get_activity_splits Per-km or per-mile split data
get_activity_weather Weather conditions during activity
get_activity_hr_zones Time in each heart rate zone
get_activity_exercise_sets Strength training sets (reps, weight)
get_activity_types All available activity types
get_progress_summary Fitness stats over a date range by activity type

Daily Health (14 tools)

Tool Description
GitHub에서 전체 README 보기

설치

npx -y @nicolasvegam/garmin-connect-mcp
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "garmin": { "command": "npx", "args": ["-y", "@nicolasvegam/garmin-connect-mcp"], "env": { "GARMIN_EMAIL": "[email protected]", "GARMIN_PASSWORD": "yourpass" } } } }