Minimal Hevy MCP

Небольшой локальный сервер Model Context Protocol, который позволяет агенту читать данные тренировок Hevy и создавать программы тренировок через публичный API Hevy.

Включённые инструменты

• hevy_list_workouts

• hevy_get_workout

• hevy_list_routines

• hevy_get_routine

• hevy_search_exercises

• hevy_get_exercise_history

• hevy_create_workout

• hevy_create_routine

Первые шесть инструментов — только для чтения. hevy_create_workout и hevy_create_routine записывают данные в подключённый аккаунт Hevy и помечены как неидемпотентные мутации.

hevy_create_routine создаёт повторно используемый план для будущей тренировки. hevy_create_workout фиксирует уже завершённую тренировку с реальным временем начала и окончания и результатами подходов. По умолчанию он делает завершённые тренировки приватными и отклоняет подходы без зафиксированного показателя результата.

Related MCP server: hevy-mcp-server

Требования

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

• Аккаунт Hevy Pro и API-ключ от https://hevy.com/settings?developer

Установка и проверка

npm install
npm run check
npm run build
npm run smoke

Локальный запуск

export HEVY_API_KEY="your-key"
npm start

Сервер обменивается данными через stdin/stdout, поэтому при прямом запуске он будет казаться молча ожидающим. Ожидается, что MCP-хост запустит его и будет с ним взаимодействовать.

Добавление в Codex

Сначала соберите сервер, сделайте HEVY_API_KEY доступным окружению, в котором запускается Codex, затем выполните:

codex mcp add hevy -- node /absolute/path/to/hevy-mcp/dist/index.js

После добавления сервера перезапустите Codex. Проверьте конфигурацию с помощью:

codex mcp list

Не коммитьте API-ключ и не передавайте его как аргумент инструмента. MCP читает его только из HEVY_API_KEY и отправляет Hevy в обязательном заголовке api-key.

Рекомендуемый первый запрос

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

Когда просите агента создать программу, требуйте, чтобы он показал полную программу и получил ваше одобрение перед вызовом hevy_create_routine.

При логировании завершённой тренировки дайте агенту фактические упражнения, результаты подходов и время. Требуйте, чтобы он показал полную тренировку и получил ваше одобрение перед вызовом hevy_create_workout. Агент никогда не должен выдумывать результаты завершённых тренировок.