Garmin Connect для Claude

Спрашивайте Claude о своих данных Garmin на простом английском.

"Как я спал прошлой ночью?" "Покажи мои пробежки за последние две недели." "Я достаточно восстановился, чтобы сегодня интенсивно тренироваться?" "Сколько я пробежал в прошлом месяце по сравнению с месяцем до этого?"

Это подключает ваш аккаунт Garmin Connect к приложению Claude Desktop, чтобы Claude мог читать ваши тренировки, сон, пульс и другие данные о здоровье и обсуждать их с вами.

Для использования этого не нужно уметь программировать. Установщик задаст вам пару вопросов и сделает всё остальное.

Что вам нужно

• Mac

• Приложение Claude Desktop

• Аккаунт Garmin Connect с часами или устройством Garmin

Related MCP server: Garmin Connect MCP Server

Установка

Откройте приложение Терминал на вашем Mac. (Нажмите Cmd + Space, введите Terminal, нажмите Enter.)

Скопируйте эту строку, вставьте её в окно Терминала и нажмите Enter:

curl -fsSL https://raw.githubusercontent.com/jharkebusch/garmin-connect-mcp/main/install.sh | bash

Он:

1. Настроит частное, самодостаточное окружение Python (ваш собственный Python на Mac не затрагивается)

2. Запросит ваш адрес электронной почты и пароль Garmin, а также код безопасности, который Garmin отправит вам

3. Настроит Claude Desktop для вас

Когда процесс завершится, полностью закройте Claude Desktop с помощью Cmd + Q и откройте его снова. Просто закрыть окно недостаточно.

Затем просто спросите Claude о своих данных Garmin.

Что может делать Claude

Здоровье и самочувствие

Тренировки и активности

Запись данных (эти изменяют ваш аккаунт Garmin)

Ничто не может удалить ваши данные. Нет инструмента, который удаляет активность, тренировку или запись веса, поэтому ошибочный запрос не может уничтожить вашу историю тренировок.

Даты на простом английском

Каждый инструмент понимает повседневные фразы, поэтому вы можете просто говорить обычным языком:

today · yesterday · last night · 3 days ago · last 7 days · this week · last month · 2026-08-18 · 2026-08-01 to 2026-08-18

Ваша конфиденциальность и безопасность

• Ваш пароль никогда не сохраняется. Он используется один раз во время настройки для входа, а затем отбрасывается.

• Сохраняются только токены доступа Garmin в ~/.garminconnect в виде файла, который может прочитать только ваша учётная запись (режим 0600, внутри папки с режимом 0700).

• Ничего не отправляется никуда, кроме Garmin. Нет телеметрии, аналитики и сторонних серверов. Ваши данные идут от Garmin к вашему Mac и больше никуда.

• Всё работает локально на вашем компьютере.

• Ваши данные Garmin попадают к Anthropic только в том случае, если Claude включает их в ответ, так же как и всё остальное, что вы вводите в Claude.

Обновление

Снова выполните ту же команду установки. Она обновляет всё на месте и сохраняет ваш вход в систему.

Если вам нужно войти снова

Сессии Garmin обновляются автоматически и редко истекают. Если Claude сообщит, что ваш вход истёк, выполните в Терминале:

garmin-mcp-setup

Если ваш Терминал не распознаёт эту команду, используйте полный путь:

~/.garmin-mcp/bin/garmin-mcp-setup

Удаление

rm -rf ~/.garmin-mcp ~/.garminconnect ~/.local/bin/garmin-mcp-setup

Затем удалите запись "garmin" из раздела mcpServers в файле ~/Library/Application Support/Claude/claude_desktop_config.json.

Устранение неполадок

Claude не видит инструменты Garmin. Полностью закройте Claude Desktop с помощью Cmd + Q и откройте его снова. Закрытие окна оставляет его работать в фоновом режиме.

"Ваш аккаунт Garmin ещё не подключён." Выполните garmin-mcp-setup в Терминале.

"Слишком много запросов." Garmin ограничивает частоту попыток входа. Подождите около 15 минут.

В ответе отсутствует какое-то числовое значение. Отсутствие означает, что ваше устройство не записало его. Некоторые показатели (HRV, Body Battery, готовность к тренировке) требуют совместимых часов Garmin, надетых на ночь. Инструменты пропускают показатель, а не угадывают значение.

Для разработчиков

git clone https://github.com/jharkebusch/garmin-connect-mcp.git
cd garmin-connect-mcp
uv venv --python 3.12 && VIRTUAL_ENV=.venv uv pip install -e ".[dev]"
VIRTUAL_ENV=.venv uv run pytest

Структура:

• src/garmin_mcp/server.py — MCP-сервер и регистрация инструментов

• src/garmin_mcp/session.py — аутентифицированный клиент Garmin, выгрузка потоков

• src/garmin_mcp/dates.py — разбор дат на простом английском

• src/garmin_mcp/format.py — обрезка JSON Garmin в читаемый текст

• src/garmin_mcp/tools/ — сами инструменты

• src/garmin_mcp/setup_cli.py — интерактивный вход и настройка Claude

Два замечания по дизайну:

• garminconnect является синхронным, поэтому каждый вызов отправляется в рабочий поток. Иначе один медленный запрос Garmin блокирует весь сервер.

• Вход не может происходить внутри вызова инструмента, потому что двухфакторный шаг Garmin требует интерактивного запроса. Установка записывает файл токена; сервер только читает его.

Важное замечание

Garmin не публикует публичный API. Этот инструмент использует тот же интерфейс, что и мобильное приложение Garmin, через библиотеку garminconnect. Он работает хорошо, но Garmin может изменить этот интерфейс в любое время и временно нарушить работу сторонних инструментов. Если это произойдёт, повторный запуск установщика подхватит исправление, как только основная библиотека выпустит его.

Этот проект не связан с Garmin Ltd., не одобрен ею и не имеет к ней отношения. Используйте его со своим собственным аккаунтом и своими данными.

Лицензия

MIT — см. LICENSE.