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.

Настройка клиентов

codex
{
    "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.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники