garmin-claude-mcp

Подключите свои данные тренировок Garmin к Claude, и пусть Claude отправляет структурированные тренировки обратно на ваши часы. Работает бесплатно. Без подписки.

Claude читает ваши последние активности и показатели самочувствия, составляет тренировку и записывает её в ваш календарь intervals.icu. Intervals.icu синхронизирует её с Garmin Connect, и она оказываhugs на ваших часах.

.

Почему это works tак

Разработческий API Garmin закрыт для частных лиц. Заявляи одобрам only for компанийт, програма в на часть вresent current time in приостановatory for новых participants in. Существуют неофициальные библы, которые воодят in систему with your Garmin password, but Garmin ужен ломал их, меняя сvoй вход.

Intervals.icu имеет официальное партнёрство с Garmin, which появилось до закрытия программиз. Он уже синхронизируется в обоих направлениях, including отправляет запланированных тренировок на ваши часи. Еще he has documented API с персиональным ключом. Так что Claude общается с intervals.icu, а intervals.icu общается с Garmin. Ваш пароль Garmin никогда не покидает Garmin.

Related MCP server: garmin-mcp-bridge

Что вам нужно

• Устройство Garmin, синхронизирующееся с Garmin Connect

• Бесплатный аккаунт intervals.icu с подключённым Garmin в Settings > Integrations и включённой «Upload planned workouts»

• Ваш API-ключ intervals.icu и идентификатор атлоэта (athlete id), оба в Settings > Developer Settings

• Бесплатный аккаунт Cloudflare

Если «Upload planned workouts» выключена, всё описанное ниже будет прекрасно работать, но ничто никогда не попадёт на ваши часы. Проверьте это в первую очередь.

Настройка

Вариант 1: кнопка Deploy

1. Нажмите кнопку выше. Cloudflare делает форк этого репозитория в ваш GitHub, создаёт KV namepsace и Durable Object и запрашивает у вас три секрета.

2. Заполните INTERVALS_API_KEY, INTERVALS_ATHLETE_ID и MCP_PASSWORD. Сострадайте пароль следующей командой: openssl rand -hex 32.

3. Заде плотйте. Вы получите URL-адрес вида https://garmin-claude-mcp.<subdomain>.workers.dev.

Вариант 2: вручную

git clone https://github.com/kbaudour/garmin-claude-mcp
cd garmin-claude-mcp
npm install

npx wrangler kv namespace create OAUTH_KV
# paste the printed id into wrangler.jsonc

npx wrangler secret put INTERVALS_API_KEY
npx wrangler secret put INTERVALS_ATHLETE_ID
npx wrangler secret put MCP_PASSWORD

npm run deploy

Подключение к Claude

В claude.ai зайдите в Settings > Connectors > Add custom connector и введите URL своего воркера с /mcp на конце:

https://garmin-claude-mcp.<subdomain>.workers.dev/mcp

Этот путь важен. Обнаружение OAuth находится в корне домена, поэтому вход в систему пройдёт успешно даже с неправильным URL, и только после этого подключение оборвётся с «Couldn't connect to the server». Если вы столкнулись с этим, удалите коннектор и добавьте его заново с путём /mcp, а не редактируйте URL на месте, чтобы устаревшая регистрация была удалена.

Затем вы увидите страницу ввода пароля. Введите MCP_PASSWORD. После подключения в вебе он работает и на мобильном.

Инструменты

Первый промпт для теста

Pull my wellness data for the last 7 days and my recent activities for the
last 14 days.

Based on what you see there, recovery, training load, how recent runs have
gone, design one run for tomorrow. Walk me through your reasoning before you
create it.

Then create it, and list my upcoming events so I can confirm it landed.

Затем откройте Garmin Connect и проверьте дату на завтра.

Известные проблемы и ограничения

• В бесплатном плане Claude доступен один кастомный коннектор. Этот solution использует его.

• На странице входа нет ограничения частоты запросов и CSRF-токена. Это однопользовательский сервер за случайным паролем длиной 64 символа. Для данного случая достаточно. Это не производительная аутентификация.

• updateWorkout и deleteEvent протестированы слабо. Остальные инструменты чтения и createWorkout подтверждённо работают по полному циклу, включая часы.

• Обновление токена в течение долгом времени не протестировано. Если коннектор протух, переподключение займёт всего несколько секунд.

• Любой, у кого есть URL вашего воркера, видит страницу входа. Без пароля он не пройдёт дальше, но URL не является секретом.

Стоимость

$0 в месяц. Бесплатный план Cloudflare Workers покрывает 100 000 запросов в день. Бесплатно включает синхронизацию Garmin. Durable Objects доступны на бесплатном тарифе с апреля 2025 года, поэтому более ранние мануалы об обратном устарели.

Лицензия

MIT