TG

taxuspt/garmin_mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

1,4 тыс. stars 449 forks Качество 87 Тренд 50MIT

MCP-сервер для доступа к данным Garmin

Обзор

Этот сервер Model Context Protocol (MCP) подключается к Garmin Connect и предоставляет ваши данные о фитнесе и здоровье Claude и другим совместимым с MCP клиентам. API Garmin доступен через отличную библиотеку python-garminconnect. - Перечислить недавние активности с поддержкой страницирования - Получить подробную информацию о активности - Редактировать активности: название, тип, описание/заметки, тип события, воспринимаемые усилия (RPE) и ощущение - Доступ к показателям здоровья (шаги, частота сердечных сокращений, сон, стресс, дыхание) - Просмотр данных состава тела - Отслеживание состояния тренировок и готовности тренировок - Доступ к метрикам FTP и порога лактата - Управление экипировкой и оборудованием - Доступ к тренировкам и планам тренировок - Проверка подробных структур шагов тренировок, включая повторные группы и цели по темпу плавания - Еженедельные показатели здоровья (шаги, стресс, минуты интенсивности) - Продвинутая аналитика велоспорта: зоны силы, анализ файлов FIT, интеллект электронных сдвигов DI2 - Тренировочный тренд нагрузки (CTL/ATL/TSB), HRV, максимальный тренд VO2, темп дыхания -...

Обзор (машинный перевод)

Этот сервер Model Context Protocol (MCP) подключается к Garmin Connect и предоставляет ваши данные о фитнесе и здоровье Claude и другим совместимым с MCP клиентам.

API Garmin доступен через отличную библиотеку python-garminconnect.

Особенности

  • Список недавних действий с поддержкой страницирования
  • Получить подробную информацию о деятельности
  • Редактировать активности: название, тип, описание/заметки, тип события, воспринимаемые усилия (RPE), ощущение и наборы силовых упражнений
  • Доступ к показателям здоровья (шаги, частота сердечных сокращений, сон, стресс, дыхание)
  • Просмотр данных о составе тела
  • Состояние и готовность подготовки на трассе
  • Доступ к метрикам циклического FTP и порога лактата
  • Управление оборудованием и оборудованием, включая свободные заметки, возвращаемые get_gear
  • Доступ к тренировкам и планам тренировок
  • Ознакомиться с детальными структурами шагов тренировки, включая повторные группы и цели по темпу плавания
  • Еженедельные показатели здоровья (шаги, стресс, минуты интенсивности)
  • Продвинутая аналитика циклов: зоны питания, анализ файлов FIT, электронный интеллект переключения DI2
  • Тренировочный тренд нагрузки (CTL/ATL/TSB), тренд HRV, тренд VO2 max, тренд частоты дыхания
  • Кривая длительности мощности, обнаружение подъёма высоты с помощью VAM, сердечный дрейф (аэробное разъединение), расчёты W/kg

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Garmin MCP Server

This Model Context Protocol (MCP) server connects to Garmin Connect and exposes your fitness and health data to Claude and other MCP-compatible clients.

Garmin’s API is accessed via the awesome python-garminconnect library.

Features

  • List recent activities with pagination support
  • Get detailed activity information
  • Edit activities: name, type, description/notes, event type, perceived effort (RPE), feel, and strength exercise sets
  • Access health metrics (steps, heart rate, sleep, stress, respiration)
  • View body composition data
  • Track training status and readiness
  • Access cycling FTP and lactate threshold metrics
  • Manage gear and equipment, including free-text notes returned by get_gear
  • Access workouts and training plans
  • Inspect detailed workout step structures, including repeat groups and swim pace targets
  • Weekly health aggregates (steps, stress, intensity minutes)
  • Advanced cycling analytics: power zones, FIT file analysis, DI2 electronic shift intelligence
  • Training load trend (CTL/ATL/TSB), HRV trend, VO2 max trend, respiration rate trend
  • Power Duration Curve, climb detection with VAM, cardiac drift (aerobic decoupling), W/kg calculations

Tool Coverage

This MCP server implements 110+ tools covering ~90% of the python-garminconnect library (v0.3.2):

  • ✅ Activity Management (21 tools) - includes write tools for type, description, event type, perceived effort, feel, and exercise sets
  • ✅ Health & Wellness (34 tools) - includes custom lightweight summary tools
  • ✅ Training & Performance (13 tools) - includes CTL/ATL/TSB, HRV, VO2 max, and respiration trends
  • ✅ Workouts (8 tools)
  • ✅ Devices (8 tools) - includes sending a workout to a device
  • ✅ Gear Management (5 tools)
  • ✅ Weight Tracking (5 tools)
  • ✅ Challenges & Badges (10 tools)
  • ✅ Nutrition (9 tools) - food logs, meals, custom foods, food logging, and multi-day intake summaries
  • ✅ Women’s Health (3 tools)
  • ✅ User Profile (3 tools)
  • ✅ High-Level Workout Builders (4 tools) - create and schedule workouts without writing JSON
  • ✅ Courses (5 tools) - list / get details / upload GPX as course / download GPX / delete course
  • ✅ Activity Analysis (2 tools) - FIT file parsing, Power Duration Curve; requires power meter and/or Di2
  • ✅ Activity File Downloads (2 tools) - download activity files in FIT, GPX, TCX, or CSV format

Note: Activity Analysis tools require a compatible power meter (e.g., Garmin Rally, Favero Assioma, PowerTap P1) and/or Shimano Di2 / SRAM eTap electronic shifting. The fitparse dependency is installed automatically.

Gear Notes

Each item in the gear array returned by get_gear includes a notes field

Открыть полный README на GitHub

Установка

uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "garmin": { "command": "uvx", "args": [ "--python", "3.12", "--from", "git+https://github.com/Taxuspt/garmin_mcp", "garmin-mcp" ] } } }