garmin-mcp

Общайтесь со своими данными Garmin. MCP-сервер только для чтения, который позволяет Claude и ChatGPT отвечать на вопросы о ваших тренировках: активности, сон, HRV, Body Battery, тренировочный статус, таблицы лидеров челленджей — а также, в отличие от других Garmin MCP-серверов, оригинальный FIT-файл, записанный вашими часами, включая каналы датчиков Connect-IQ (Stryd, Moxy/SmO2, CORE).

You:  How did my last long run compare to the same route in June?
You:  Why is my training readiness so low this morning?
You:  Where do I stand in the running challenge, and who is ahead of me?
You:  Did my Stryd actually record power on Tuesday's session?

Он никогда не пишет в Garmin Connect. Каждый инструмент доступен только для чтения.

Три способа использования

1. Гостевой доступ — единственный способ, которому вообще не нужна инфраструктура: откройте пригласительную ссылку, создайте аккаунт, подключите свой Garmin — и готово. Как и способ 3, он работает с claude.ai в браузере и с ChatGPT — способ 2 так не может, потому что ни claude.ai, ни ChatGPT не могут запустить программу на вашем компьютере.

Гостевой доступ ещё не открыт. Сейчас он работает с небольшой группой тестировщиков по личным приглашениям. Публичный способ запросить приглашение запланирован — а пока способы 2 и 3 готовы к использованию уже сегодня.

2. Локально — ничего не покидает вашу машину, никаких аккаунтов и серверов. Ваш ИИ-клиент запускает процесс, когда он ему нужен. Лучший вариант, если вы всё равно пользуетесь Claude Desktop или Claude Code и хотите, чтобы всё оставалось локальным.

3. Свой сервер — то же программное обеспечение, на котором работает гостевой доступ. Запустите его для себя, приглашайте кого хотите, владейте данными. См. docs/self-hosting.md.

Быстрый старт (локально)

uv tool install git+https://github.com/mskerwiderski/mcp-garmin

garmin-mcp login

При входе запрашивается ваш e-mail Garmin, пароль и — если она у вас включена — код многофакторной аутентификации. Сохраняются только OAuth-токены Garmin, в ~/.garmin-mcp/tokens.json с правами 0600. Ваш пароль нигде не записывается.

Затем зарегистрируйте сервер в вашем клиенте:

claude mcp add garmin -- garmin-mcp serve

Начните новый сеанс и задайте какой-нибудь вопрос. Полное пошаговое руководство, включая Claude Desktop: docs/install-claude.md.

Документация

На что он может ответить

Активности — список и фильтрация по виду спорта и дате, собственная сводка Garmin по одной активности и та же активность в том виде, в котором её записал прибор, — напрямую из FIT-файла. Временные ряды для любого канала в файле, детали плавания в бассейне вплоть до каждого отдельного отрезка и сведения о том, какие датчики Connect-IQ реально передавали данные.

Здоровье — один вызов в день даёт шаги, пульс в покое, стресс, Body Battery, фазы сна с оценкой, статус HRV и готовность к тренировке. Плюс тренировочный статус с фокусом нагрузки и VO2max, состав тела и артериальное давление за диапазон дат.

Тенденции и план — целый месяц шагов, Body Battery и VO2max одним вызовом вместо одного в день; запланированная часть Garmin с тренировками по плану и гонками, так что можно сравнить «что было запланировано» и «что произошло».

Где вы находитесь — прогнозы результатов от 5 км до марафона, фитнес-возраст, показатели выносливости и холмов, итоги за всё время и личные рекорды с указанием активности, в которой каждый из них был установлен.

Контекст — ваши пороги и пульсовые зоны, ваше снаряжение с активностями, километрами, часами и днями, которые за ним стоят, а также социальные челленджи, в которых вы соревнуетесь с друзьями, включая тот, что сейчас в процессе.

Полный список с параметрами см. в docs/tools.md.

Почему вход происходит на вашей машине

SSO Garmin находится за Cloudflare, который с марта 2026 года отвечает на новые входы с IP-адресов дата-центров кодами 429 или 403. Поэтому garmin-mcp login запускается там, где находитесь вы. Полученный OAuth1-токен действителен около года и выпускает токены доступа к connectapi.garmin.com, так что после входа ничто больше не обращается к sso.garmin.com.

Размещённый сервер предлагает оба варианта: форму входа (пароль используется один раз и нигде не хранится) и вставку блока токена из garmin-mcp export — это способ получить доступ, когда Garmin блокирует адрес сервера.

Полезно знать

Здесь используется внутренний Connect API Garmin — тот же, что используют все инструменты сообщества. Официального API для частных лиц не существует: Health API от Garmin — это партнёрская программа. Используйте это для своего аккаунта, а размещённый инстанс держите для людей, которых вы действительно знаете: все аккаунты на одном сервере выходят на Garmin с одного адреса.

Ответы намеренно компактные. Garmin отвечает сотнями полей на каждую активность и временными рядами из тысяч точек; всё сводится к тому, что модель действительно может использовать, а потоки пересэмплируются с агрегацией min/max/avg по каждому каналу. Это не косметика — сырые данные съели бы окно контекста, необходимое для диалога.

Разработка

python3.12 -m venv .venv && .venv/bin/pip install -e ".[dev]"

.venv/bin/pytest

103 теста, сетевой доступ не требуется — API Garmin и FIT-файлы заменены заглушками или синтезированы. О том, как части соединяются друг с другом, см. docs/architecture.md.

Лицензия

MIT. См. LICENSE.