Garmin Personal MCP
Garmin Personal MCP — MCP-сервер сообщества (автор — Mason-Levyy). Garmin Connect через официальный Personal API: сон, вариабельность пульса и активность. Ставится через uvx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- Mason-Levyy
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- Не указана
- Языки
- python
Уровень риска: high
Только чтение Garmin Personal API; файлы активностей сохраняются в GARMIN_MCP_DOWNLOAD_DIR.
Настройка клиентов
{
"code": "codex mcp add garmin -- uvx garmin-personal-mcp",
"lang": "sh",
"verified": "docs"
}
Неофициальный проект, официальный API. Сервер сделан не Garmin, но обращается только к документированному Personal API Garmin через собственный Python-клиент Garmin.
Что умеет
Garmin Personal MCP — бесплатный MCP-сервер с открытым кодом, который подключает ваш аккаунт Garmin Connect к Claude, Cursor, VS Code и другим клиентам. Спрашивайте о сне прошлой ночью, трендах вариабельности пульса (HRV), Body Battery, стрессе, тренировочной нагрузке, весе или конкретной пробежке — по реальным данным вашего аккаунта. Сервер работает через Personal API с отзываемым ключом, поэтому пароль Garmin ему не нужен, и он только читает данные.
Чем отличается от других серверов для Garmin. Большинство входят по паролю через неофициальную библиотеку garminconnect, которая ломается при каждом изменении входа. В октябре 2026 года Garmin открыл Personal API для частных лиц, и этот сервер использует его:
- без пароля и парсинга — отзываемый ключ, который обменивается на короткоживущие токены;
- весь Personal API — у каждой рабочей конечной точки есть инструмент со всеми документированными фильтрами;
- любой диапазон дат — длинные периоды (больше 28 дней для шагов, 31 для сна и т. д.) автоматически разбиваются на запросы;
- компактные ответы — поминутные массивы отбрасываются, если вы их не попросите.
Инструменты (26): обзор дня garmin_get_day, суточные сводки, шаги, стресс, гидратация, Body Battery, пульс, SpO2, сон и сводки сна, HRV, вес и цели по весу, дневник питания, поиск активностей со всеми фильтрами Garmin, подробности активности с отрезками, структурированные тренировки, профиль, пульсовые зоны, фитнес-возраст и данные менструального цикла. garmin_download_activity сохраняет исходный файл активности (ZIP с .fit) на машине сервера.
Кому подойдёт
Владельцам часов Garmin, которые хотят анализировать сон, восстановление и тренировки вместе с ИИ. Personal API предназначен только для ваших собственных данных. Похожие серверы — в категории разное.
Установка
Нужен uv. Сначала один раз сохраните ключ: в веб-версии Garmin Connect откройте Settings → Personal API, создайте ключ (срок от 30 дней до года, показывается один раз) и выполните uvx garmin-personal-mcp auth. Сервер проверит ключ и сохранит его в ~/.config/garmin/connect-personal-api-key с правами только для владельца. Вместо файла можно задать GARMIN_PERSONAL_API_KEY. Команда auth --check проверяет, действует ли ключ; за неделю до истечения Garmin пришлёт письмо.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add garmin -- uvx garmin-personal-mcpТот же JSON подходит для Claude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json), Windsurf и Cline. В Claude Code сервер можно поставить и как плагин — тогда ключ запрашивается при установке.
Проверка
Спросите: «Как я спал прошлой ночью?»
Примеры задач
Падает ли моя HRV в этом месяце?Сравни три мои последние длинные пробежки.Риски
- Личные данные о здоровье уходят в подключённый клиент и модель. Сам сервер общается только с Garmin.
- Ключ API хранится локально; его можно отозвать в Garmin Connect.
- Запись файлов — только
garmin_download_activity, в каталогGARMIN_MCP_DOWNLOAD_DIR, за его пределы инструмент писать не может. Изменить данные в аккаунте Garmin сервер не может. - HTTP-режим без авторизации — не открывайте его в интернет, используйте VPN или прокси с аутентификацией.
Частые вопросы
Нужен ли пароль Garmin?
Нет, только отзываемый ключ Personal API.
Может ли сервер менять мои данные?
Нет, Personal API только для чтения.
Можно ли смотреть чужие аккаунты?
Нет, только свои данные.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Everything
Эталонный тестовый сервер, который демонстрирует все возможности протокола MCP.
Time
Эталонный сервер для получения текущего времени и перевода между часовыми поясами.
Reactive Resume
Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.
AIHOT
Новости ИИ на китайском: темы, события и сводки.