Garmin Connect — MCP-сервер для Claude Code: обзор и запуск
Доставляет показатели здоровья и тренировок из Garmin Connect в чат с моделью. Работает только на чтение через официальный Personal API по токену.
claude mcp add --env GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> --env GARMIN_MCP_DOWNLOAD_DIR=<GARMIN_MCP_DOWNLOAD_DIR> --transport stdio garmin-connect -- uvx garmin-personal-mcpЧто делает Garmin Connect
Сервер запрашивает показатели сна, уровень Body Battery и совершённые тренировки. Вместо парсинга веб-интерфейса и передачи пароля от аккаунта он обращается к официальному Garmin Personal API через клиентскую библиотеку от Garmin. Все запросы выполняются строго на чтение, поэтому изменить записи в профиле через модель невозможно.
Для длинных временных отрезков сервер сам делит диапазон дат на допустимые интервалы: шаги запрашиваются блоками до 28 дней, а сон — до 31 дня. Массивы поминутных замеров за весь день по умолчанию отсекаются, чтобы не перегружать контекст модели лишними цифрами.
Без утилиты uv и предварительно созданного токена в настройках Garmin Connect сервер не запустится. Авторизоваться можно один раз через команду uvx garmin-personal-mcp auth либо передав переменную окружения GARMIN_PERSONAL_API_KEY.
Какие задачи решает
- смотреть отчёт о сне и динамику HRV за месяц
- сравнивать пульс и темп в последних пробежках
- проверять уровень стресса и заряд Body Battery перед тренировкой
- выгружать статистику активности за произвольные даты
Примеры запросов агенту
- Как я спал прошлой ночью и какой был Body Battery утром?
- Сравни средний темп и пульс на моих трёх последних пробежках.
- Покажи динамику HRV за последние четыре недели.
Как установить Garmin Connect
Командой платформы
claude mcp add --env GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> --env GARMIN_MCP_DOWNLOAD_DIR=<GARMIN_MCP_DOWNLOAD_DIR> --transport stdio garmin-connect -- uvx garmin-personal-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-personal-mcp <команда>
Командой платформы
codex mcp add garmin-connect --env GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> --env GARMIN_MCP_DOWNLOAD_DIR=<GARMIN_MCP_DOWNLOAD_DIR> -- uvx garmin-personal-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-personal-mcp <команда>
Файл настроек
{
"mcpServers": {
"garmin-connect": {
"command": "uvx",
"args": [
"garmin-personal-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>",
"GARMIN_MCP_DOWNLOAD_DIR": "<GARMIN_MCP_DOWNLOAD_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-personal-mcp <команда>
Файл настроек
{
"servers": {
"garmin-connect": {
"type": "stdio",
"command": "uvx",
"args": [
"garmin-personal-mcp"
],
"env": {
"GARMIN_PERSONAL_API_KEY": "<GARMIN_PERSONAL_API_KEY>",
"GARMIN_MCP_DOWNLOAD_DIR": "<GARMIN_MCP_DOWNLOAD_DIR>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-personal-mcp <команда>
Командой платформы
gemini mcp add -e GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> -e GARMIN_MCP_DOWNLOAD_DIR=<GARMIN_MCP_DOWNLOAD_DIR> garmin-connect uvx garmin-personal-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from garmin-personal-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Garmin Connect
Как установить Garmin Connect в Claude Code?
Выполните команду claude mcp add garmin-personal-mcp -e GARMIN_PERSONAL_API_KEY=<GARMIN_PERSONAL_API_KEY> -- uvx garmin-personal-mcp, подставив свой персональный ключ.
Что делает этот MCP-сервер?
Он открывает ассистенту доступ к данным о тренировках, сне, пульсе и восстановлении из официального API Garmin Connect.
Нужно ли передавать логин и пароль от Garmin?
Нет. Сервер использует отзывной ключ из настроек Garmin Connect, поэтому пароль от аккаунта вводить не требуется.
