Hevy MCP Server — MCP-сервер для Claude Code: функции и установка
Сервер связывает ИИ-ассистента с данными Hevy: он помогает анализировать тренировки и управлять записями. Для подключения нужен ключ Hevy API и подписка Hevy PRO.
claude mcp add hevy-mcp -e HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcpЧто делает Hevy MCP Server
Через Hevy MCP Server ассистент читает и анализирует тренировки, программы, шаблоны упражнений и замеры тела. Он также может создавать и обновлять эти данные через Hevy API. Например, можно запросить динамику тренировок за несколько недель или найти упражнения в сохранённой программе.
Сервер работает с Claude Code, Codex, Cursor и другими MCP-клиентами из списка совместимых платформ. Для локального запуска используется npx; ключ передаётся через переменную HEVY_API_KEY. Доступ к API требует Hevy PRO, поэтому без подписки подключение не заработает.
Какие задачи решает
- суммировать тренировки за выбранный период
- найти часто выполняемые упражнения и пропуски в занятиях
- посмотреть упражнения и подходы в сохранённой программе
- создать тренировку или обновить замеры тела
Примеры запросов агенту
- Проанализируй мои тренировки за последние недели и укажи, какие упражнения встречаются чаще всего.
- Найди мою программу для тренировки груди и покажи упражнения с подходами.
- Создай завершённую тренировку по сохранённой программе и спроси недостающие результаты подходов.
Как установить Hevy MCP Server
Командой платформы
claude mcp add hevy-mcp -e HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add hevy-mcp-server --env HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"hevy-mcp-server": {
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "<HEVY_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"hevy-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "<HEVY_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HEVY_API_KEY=<HEVY_API_KEY> hevy-mcp-server npx -y hevy-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Hevy MCP Server
Как установить Hevy MCP Server в Claude Code?
Сначала задайте ключ Hevy API и добавьте сервер командой claude mcp add hevy-mcp -e HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcp. Для работы API требуется подписка Hevy PRO.
Что делает Hevy MCP Server?
Он подключает ИИ-ассистента к Hevy API, чтобы читать и анализировать тренировки, программы, упражнения и замеры тела, а также создавать и обновлять эти данные.
Что нужно для работы Hevy MCP Server?
Нужен ключ Hevy API. Доступ к API требует подписки Hevy PRO.
