Garmin MCP: сон, ВСР и тренировки из Garmin Connect в Claude и Cursor

Taxuspt/garmin_mcp· Проверено 12.11.2026· 1,5 тыс.на GitHub

Подключает агента к вашему аккаунту Garmin Connect: сон, ВСР, Body Battery, стресс, тренировки и нагрузка. Один из серверов умеет ещё собирать тренировки и ставить их в календарь.

3 реализации:

Самый полный: 155 инструментов на чтение и запись, конструкторы тренировок, разбор FIT-файлов, зон по ваттам и Di2; вход по логину и паролю через python-garminconnect.

Как подключить

Что сделать до подключения

Python 3.12 или новее и uv с командой uvx

Один раз войти в терминале: uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp-auth — команда спросит почту, пароль и код MFA и сохранит токены в ~/.garminconnect

GARMIN_EMAIL, GARMIN_PASSWORD

почта и пароль Garmin Connect; нужны один раз для garmin-mcp-auth, после входа в конфиг клиента их можно не писать

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio garmin \
  -- uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.garmin]
command = "uvx"
args = ["--python", "3.12", "--from", "git+https://github.com/Taxuspt/garmin_mcp", "garmin-mcp"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "garmin": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "garmin": {
        "type": "local",
        "command": [
          "uvx",
          "--python",
          "3.12",
          "--from",
          "git+https://github.com/Taxuspt/garmin_mcp",
          "garmin-mcp"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_activitiesсписок последних тренировок

get_activities_by_dateищет тренировки за период

get_activityсводка по тренировке

get_activity_splitsотрезки тренировки

get_sleep_dataчитает данные сна

get_hrv_trendтренд ВСР за период

get_body_batteryчитает Body Battery

get_stress_summaryсводка стресса

get_training_readinessготовность к тренировке

get_training_load_trendострая и хроническая нагрузка

get_vo2max_trendтренд VO2 max

get_power_duration_curveстроит Power Duration Curve

get_activity_fit_dataразбирает FIT-файл заезда

download_activity_fileскачивает FIT, GPX, TCX или CSV

create_walk_run_workoutсобирает интервалы ходьба-бег

create_strength_workoutсобирает силовую тренировку

schedule_weekставит тренировки на неделю

push_workout_to_deviceотправляет тренировку на часы

set_activity_exercise_setsзаписывает подходы силовой

delete_activityудаляет тренировку с подтверждением

Показано 20 из 155.

Работает через Personal API от Garmin по отзываемому ключу, без пароля, и только читает данные.

Как подключить

Что сделать до подключения

uv с командой uvx

Ключ Personal API, сохранённый командой uvx garmin-personal-mcp auth

GARMIN_PERSONAL_API_KEY

Garmin Connect в браузере → Settings → Personal API → создать ключ на срок от 30 дней до года; Garmin показывает его один раз. Переменная нужна, только если ключ не сохранён командой auth

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio garmin-personal-mcp \
  -- uvx garmin-personal-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.garmin-personal-mcp]
command = "uvx"
args = ["garmin-personal-mcp"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "command": "uvx",
      "args": ["garmin-personal-mcp"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["garmin-personal-mcp"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "command": "uvx",
      "args": ["garmin-personal-mcp"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "command": "uvx",
      "args": ["garmin-personal-mcp"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "garmin-personal-mcp": {
        "type": "local",
        "command": ["uvx", "garmin-personal-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "command": "uvx",
      "args": ["garmin-personal-mcp"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "garmin-personal-mcp": {
      "command": "uvx",
      "args": ["garmin-personal-mcp"]
    }
  }
}

Инструменты сервера

garmin_get_dayдень целиком: сон, ВСР, стресс, тренировки

garmin_get_daily_summariesдневные сводки за период

garmin_get_sleepодна ночь сна подробно

garmin_get_sleep_summariesсон за период

garmin_get_hrv_summariesВСР и базовый уровень за период

garmin_get_body_batteryзаряд и расход Body Battery

garmin_get_stressуровень стресса за день

garmin_get_heart_rateпульс покоя, минимум и максимум

garmin_get_weightвес за период

garmin_get_food_logдневник питания

garmin_search_activitiesищет тренировки по фильтрам

garmin_get_activityтренировка с отрезками

garmin_download_activityсохраняет исходный файл тренировки

garmin_get_heart_rate_zonesпульсовые зоны по видам спорта

garmin_get_menstrual_cycleфаза цикла и прогноз

Показано 15 из 26.

Вариант на Node.js: 61 инструмент только на чтение, ставится одной командой через npx, вход по почте и паролю.

Как подключить

Что сделать до подключения

Node.js 20 или новее

При включённой MFA один раз выполнить в терминале setup: GARMIN_EMAIL='…' GARMIN_PASSWORD='…' npx -y @nicolasvegam/garmin-connect-mcp setup

GARMIN_EMAIL, GARMIN_PASSWORD

почта и пароль от аккаунта Garmin Connect; токены после входа кэшируются в ~/.garmin-mcp/

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'GARMIN_EMAIL=<почта Garmin Connect>' --env 'GARMIN_PASSWORD=<пароль Garmin Connect>' --transport stdio garmin-connect-mcp \
  -- npx -y @nicolasvegam/garmin-connect-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.garmin-connect-mcp]
command = "npx"
args = ["-y", "@nicolasvegam/garmin-connect-mcp"]

[mcp_servers.garmin-connect-mcp.env]
GARMIN_EMAIL = "<почта Garmin Connect>"
GARMIN_PASSWORD = "<пароль Garmin Connect>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "garmin-connect-mcp": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "<почта Garmin Connect>",
        "GARMIN_PASSWORD": "<пароль Garmin Connect>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "garmin-connect-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "<почта Garmin Connect>",
        "GARMIN_PASSWORD": "<пароль Garmin Connect>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "garmin-connect-mcp": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "<почта Garmin Connect>",
        "GARMIN_PASSWORD": "<пароль Garmin Connect>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "garmin-connect-mcp": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "<почта Garmin Connect>",
        "GARMIN_PASSWORD": "<пароль Garmin Connect>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "garmin-connect-mcp": {
        "type": "local",
        "command": ["npx", "-y", "@nicolasvegam/garmin-connect-mcp"],
        "environment": {
          "GARMIN_EMAIL": "<почта Garmin Connect>",
          "GARMIN_PASSWORD": "<пароль Garmin Connect>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "garmin-connect-mcp": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "<почта Garmin Connect>",
        "GARMIN_PASSWORD": "<пароль Garmin Connect>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "garmin-connect-mcp": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "<почта Garmin Connect>",
        "GARMIN_PASSWORD": "<пароль Garmin Connect>"
      }
    }
  }
}

Инструменты сервера

get_last_activityпоследняя тренировка

get_activity_detailsпульс, темп и высота по времени

get_activity_hr_zonesвремя в пульсовых зонах

get_activity_weatherпогода во время тренировки

get_daily_summaryсводка за день

get_sleep_dataфазы сна и оценка

get_body_batteryуровни Body Battery

get_hrvчитает ВСР

get_training_statusстатус и нагрузка

get_race_predictionsпрогноз на 5 км и марафон

get_personal_recordsличные рекорды

get_devicesсписок устройств Garmin

Показано 12 из 61.

Что попросить агента

«Как я спал прошлой ночью?»Агент вызовет get_sleep_data в Garmin MCP Server или garmin_get_sleep в Garmin Personal MCP

«Покажи мою ВСР за последние 2 недели и отметь, где восстановление проседает»Агент вызовет get_hrv_trend или garmin_get_hrv_summaries за нужный период

«Сравни мои последние 3 длинные пробежки»Агент найдёт их через get_activities или garmin_search_activities и откроет каждую через get_activity с отрезками

«Покажи power duration curve по вчерашнему заезду и оцени мой FTP»Агент вызовет get_power_duration_curve и get_activity_fit_data в Garmin MCP Server

«Собери интервалы ходьба-бег 2:2 на 9 повторов и поставь на <дата>»Агент вызовет create_walk_run_workout, затем schedule_week или schedule_workout в Garmin MCP Server

Для каких задач

Разобрать сон, ВСР, Body Battery и стресс за ночь или за несколько недель

Сравнить последние пробежки или заезды по отрезкам и пульсовым зонам

Посчитать тренд нагрузки и VO2 max и прикинуть FTP по Power Duration Curve

Собрать интервальную или силовую тренировку, поставить её в календарь и отправить на часы

Выгрузить файл тренировки в FIT, GPX, TCX или CSV

Ограничения

Все три сервера сторонние, Garmin их не выпускает; Garmin MCP Server и garmin-connect-mcp входят по паролю через стороннюю библиотеку python-garminconnect

Garmin MCP Server по умолчанию регистрирует 155 инструментов, это много контекста; урежьте набор переменной GARMIN_TOOL_PROFILE, например minimal на 20 инструментов

Запись в Garmin MCP Server без отмены: delete_activity удаляет тренировку после повторного вызова с confirm=true, set_activity_exercise_sets заменяет все подходы, включая распознанные часами

Garmin Personal MCP только читает и работает лишь с вашим аккаунтом; ключ живёт от 30 дней до года, потом нужен новый

Если не работает

Claude Desktop пишет Failed to spawn process: No such file or directory

Клиент не видит uvx в PATH. Узнайте путь командой which uvx и укажите его полностью в command.

Сервер пишет MFA required; run 'garmin-mcp-auth' before starting the server

Выполните garmin-mcp-auth в терминале, введите почту, пароль и код MFA и перезапустите клиент.

garmin-mcp-auth прошёл, а сервер всё равно не входит

Клиент запускает сервер с другим HOME или GARMINTOKENS, чем терминал, и ищет токены в другой папке; частый случай — Claude Desktop на Windows. Сравните пути командой garmin-mcp-auth --diagnose.

На Windows 11 Smart App Control блокирует uv и uvx

Переустановите uv через winget install --id=astral-sh.uv -e и укажите в command полный путь к uvx.exe. Если не помогает, запустите сервер через Docker Compose.

Garmin Personal MCP пишет Garmin rejected the Personal API key

Ключ истёк или удалён. Создайте новый в Settings → Personal API и выполните garmin-personal-mcp auth.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Garmin MCP Server	Taxuspt	1,5 тыс.	локально	токен	155	24 октября 2026
Garmin Personal MCP	Mason-Levyy	69	локально	токен	26	4 ноября 2026
garmin-connect-mcp	Nicolasvegam	191	локально	токен	61	5 ноября 2026

Частые вопросы

Нужен ли серверу мой пароль от Garmin?

Garmin MCP Server и garmin-connect-mcp входят по почте и паролю и сохраняют токены на диске. Garmin Personal MCP работает по ключу Personal API, который вы создаёте в настройках Garmin Connect, пароль ему не нужен.

У меня включена двухфакторная защита, сервер не входит. Что делать?

Сервер в фоне не может спросить код. Войдите один раз в терминале: garmin-mcp-auth для Garmin MCP Server или команда setup для garmin-connect-mcp. Токены сохранятся, и сервер будет брать их сам.

Может ли агент изменить или удалить мои тренировки?

Garmin MCP Server умеет править название, тип, описание и подходы тренировки, добавлять вес и удалять тренировки; удаление требует повторного вызова с confirm=true. Garmin Personal MCP и garmin-connect-mcp только читают.

Как долго живут токены?

У Garmin MCP Server токены действуют около 6 месяцев, потом запустите garmin-mcp-auth --force-reauth. Ключ Personal API действует от 30 дней до года, о скором окончании Garmin пишет на почту примерно за неделю.

Как подключить два аккаунта Garmin?

В Garmin MCP Server запустите по экземпляру сервера на каждый аккаунт, каждому — своя папка токенов в переменной GARMINTOKENS. Войдите в каждый командой garmin-mcp-auth --token-path <папка>.

Какой Garmin MCP server выбрать?

Garmin MCP Server на Python даёт больше всего инструментов и умеет записывать тренировки. Garmin Personal MCP обходится без пароля и только читает. garmin-connect-mcp на Node.js ставится через npx и тоже только читает.

Как подключить Garmin MCP к Claude Code?

Для Garmin Personal MCP выполните claude mcp add garmin -- uvx garmin-personal-mcp, для garmin-connect-mcp — claude mcp add garmin -e GARMIN_EMAIL=… -e GARMIN_PASSWORD=… -- npx -y @nicolasvegam/garmin-connect-mcp. Конфиги остальных клиентов — во вкладках блока «Как подключить».

Как подключить Garmin MCP к Codex?

Для Garmin Personal MCP выполните codex mcp add garmin -- uvx garmin-personal-mcp. Garmin MCP Server прописывается в config.toml с command = "uvx" и теми же аргументами, что во вкладке Codex.

Работает ли сервер из России?

Серверы запускаются на вашем компьютере и ходят в Garmin Connect под вашим аккаунтом; для Garmin Connect China в Garmin MCP Server есть переменная GARMIN_IS_CN=true.

Garmin MCP: сон, ВСР и тренировки из Garmin Connect в Claude и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы