Garmin Personal MCP
Garmin Personal MCP отвечает на вопросы о сне, HRV и тренировках по данным аккаунта Garmin Connect, только чтение
- 69 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер читает личные данные о здоровье из аккаунта Garmin Connect, включая сон, пульс и тренировки
- Ключ Personal API хранится в файле `~/.config/garmin/connect-personal-api-key`
Установка
- Работает в
Ручная установка
claude mcp add garmin -- uvx garmin-personal-mcpПеред этим один раз `uvx garmin-personal-mcp auth` с ключом Personal API.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает личные данные о здоровье из аккаунта Garmin Connect, включая сон, пульс и тренировки
- Ключ Personal API хранится в файле `~/.config/garmin/connect-personal-api-key`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Garmin Personal MCP — бесплатный сервер с открытым кодом, который связывает аккаунт Garmin Connect с Claude, Cursor, VS Code и другими клиентами MCP. Можно спросить про вчерашний сон, динамику HRV, Body Battery, стресс, нагрузку, вес или конкретную пробежку. Сервер работает через официальный Personal API Garmin с отзывным ключом, пароль от аккаунта не нужен, доступ только на чтение. Каждый рабочий метод справочника Garmin получил свой инструмент со всеми документированными фильтрами. Диапазоны длиннее допустимых, например 28 дней для шагов и 31 для сна, режутся на запросы автоматически. Массивы значений за весь день по умолчанию не включаются, чтобы ответ помещался в окно модели. Проект неофициальный: Garmin его не выпускала, он использует документированный Personal API и клиент Garmin на Python. Пакет опубликован на PyPI и в официальном реестре MCP.
Для кого. Владельцам часов Garmin, которые хотят обсуждать сон, восстановление и тренировки с Claude или Cursor на данных своего аккаунта.
Подходит, если
- Хочется понять, снижается ли HRV за месяц и как это связано со сном
- Нужно сравнить три последние длинные пробежки по темпу и нагрузке
- Агент должен смотреть Body Battery и стресс без вашего пароля от Garmin
- Данные за год нужно вытащить одним запросом, и диапазон делится сам
- Сервер подключается к Cursor или VS Code одной кнопкой установки
Не подходит, если
- Нужно записывать тренировки или менять настройки часов: Personal API только читает
- У вас нет доступа к Personal API Garmin Connect
- Нужен вход по логину и паролю через неофициальную библиотеку: сервер этого не делает
Пример запроса к агенту
Как я спал на прошлой неделе и снижается ли мой HRV за этот месяц? Сравни последние три длинные пробежкиMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Ограничения
Нужен ключ Personal API, который создается в настройках Garmin Connect на срок от 30 дней до года и показывается один раз. Ключ сохраняется в `~/.config/garmin/connect-personal-api-key` с правами только владельца. Garmin предупреждает о сроке за неделю, и тогда выполняется `auth` заново. Сервер не меняет данные аккаунта. Все ответы строятся по документированному Personal API, который Garmin открыла для частных лиц в октябре 2026 года. Нужен `uv`.
Как отключить. Удалите запись сервера из клиента, например `claude mcp remove garmin`, а ключ отзовите в настройках Garmin Connect и удалите файл `~/.config/garmin/connect-personal-api-key`.
Частые вопросы
Как подключить Garmin Personal MCP к Claude Code?
Сначала сохраните ключ командой `uvx garmin-personal-mcp auth`, затем выполните `claude mcp add garmin -- uvx garmin-personal-mcp`. Есть и плагин через `/plugin install`.
Нужен ли пароль от Garmin?
Нет. Сервер использует отзывной ключ Personal API и обменивает его на короткоживущие токены.
Может ли сервер что-то изменить в аккаунте?
Нет, Personal API только читает, и сервер тоже.
Чем он отличается от других серверов Garmin?
Большинство входят по паролю через неофициальную библиотеку `garminconnect`, которая ломается при смене входа Garmin. Этот работает через официальный Personal API.
Как узнать, что ключ еще действует?
Выполните `garmin-personal-mcp auth --check`: команда сообщит, работает ли сохраненный ключ, без запроса пароля.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыGarmin MCP
garmin-mcp
Данные Garmin Connect для агента: активности, здоровье, правка названий и заметок. Работает через неофициальную библиотеку python-garminconnect
MCP-сервер Garmin Connect отдает агенту сон, пульс, HRV, активности и тренировки, а новые тренировки создает после подтверждения.
MCP-сервер только для чтения: восстановление, сон, HRV, нагрузка и тренировки из WHOOP в Claude, Codex и Cursor.
coros-mcp (сообщество)
coros-mcp
Неофициальный MCP-сервер Coros: сон, HRV, нагрузка и тренировки из Training Hub и планирование занятий в календаре.
Официальный MCP COROS: агент читает тренировки, сон и пульс и составляет планы тренировок, сохраняя их в аккаунт.
MCP-сервер для учета тренировок: Claude Desktop, Cursor и Cline читают программы, подходы, вес тела и 1ПМ из вашего самостоятельно развернутого openGym
Коротко о README
В README сервер назван способом спрашивать агента о данных Garmin через официальный API. Там есть сравнение с другими серверами Garmin, быстрый старт для Claude Code, Cursor, VS Code, Codex и Gemini CLI, раздел аутентификации и список инструментов.