Hermes Grocy MCP — MCP-сервер для Claude Code: установка и обзор
MCP-сервер Hermes Grocy MCP для Claude Code связывает ассистента с домашней системой учёта Grocy. Управляет запасами продуктов, списками покупок, штрихкодами и домашними делами.
MIT ★ 5 обновлён 2026-08-01
claude mcp add --env GROCY_BASE_URL=<GROCY_BASE_URL> --env GROCY_API_KEY=<GROCY_API_KEY> --transport stdio hermes-grocy-mcp -- uvx hermes-grocy-mcpЧто делает Hermes Grocy MCP
Сервер даёт набор инструментов для взаимодействия со службой Grocy через API. Он позволяет искать продукты по каталогу, считывать штрихкоды и Grocycode, проверять остатки на складе, а также отслеживать позиции с истекающим сроком годности.
Инструменты записи меняют базу данных напрямую: списывают или приходуют товары, правят списки покупок, закрывают задачи по дому и обновляют произвольные сущности Grocy через JSON.
Для работы с приватным сервером и выполнения операций записи требуется GROCY_API_KEY, создаваемый в веб-интерфейсе Grocy. Адрес инстанса задаётся переменной GROCY_BASE_URL; без указания ключа сервер обращается к публичному демо-стенду в режиме только для чтения.
Какие задачи решает
- проверить запасы еды и список просроченных продуктов в Grocy
- добавить или списать позиции со склада инвентаря
- внести товары в списки покупок или найти позицию по штрихкоду
- отметить выполнение регламентных домашних дел и задач
Примеры запросов агенту
- Покажи список продуктов с истекающим сроком годности в Grocy
- Найди товар по штрихкоду 4006381333931 и спиши две штуки
- Добавь овсяное молоко в мой список покупок
Как установить Hermes Grocy MCP
Командой платформы
claude mcp add --env GROCY_BASE_URL=<GROCY_BASE_URL> --env GROCY_API_KEY=<GROCY_API_KEY> --transport stdio hermes-grocy-mcp -- uvx hermes-grocy-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hermes-grocy-mcp <команда>
Командой платформы
codex mcp add hermes-grocy-mcp --env GROCY_BASE_URL=<GROCY_BASE_URL> --env GROCY_API_KEY=<GROCY_API_KEY> -- uvx hermes-grocy-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hermes-grocy-mcp <команда>
Файл настроек
{
"mcpServers": {
"hermes-grocy-mcp": {
"command": "uvx",
"args": [
"hermes-grocy-mcp"
],
"env": {
"GROCY_BASE_URL": "<GROCY_BASE_URL>",
"GROCY_API_KEY": "<GROCY_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hermes-grocy-mcp <команда>
Файл настроек
{
"servers": {
"hermes-grocy-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"hermes-grocy-mcp"
],
"env": {
"GROCY_BASE_URL": "<GROCY_BASE_URL>",
"GROCY_API_KEY": "<GROCY_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hermes-grocy-mcp <команда>
Командой платформы
gemini mcp add -e GROCY_BASE_URL=<GROCY_BASE_URL> -e GROCY_API_KEY=<GROCY_API_KEY> hermes-grocy-mcp uvx hermes-grocy-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hermes-grocy-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Hermes Grocy MCP
Как установить Hermes Grocy MCP в Claude Code?
Выполните команду claude mcp add --env GROCY_BASE_URL=<GROCY_BASE_URL> --env GROCY_API_KEY=<GROCY_API_KEY> --transport stdio hermes-grocy-mcp -- uvx hermes-grocy-mcp.
Что делает Hermes Grocy MCP?
Подключает ИИ к системе Grocy для инвентаризации продуктов, ведения списков покупок, распознавания штрихкодов и закрытия домашних дел.
Что нужно для работы Hermes Grocy MCP?
Нужен доступный инстанс Grocy и ключ GROCY_API_KEY для авторизации запросов на изменение данных.