Hermes Grocy MCP — Claude Code MCP server: setup and use
Hermes Grocy MCP is an MCP server for Claude Code that integrates assistants with a self-hosted Grocy instance. Manages home inventory, groceries, barcode lookups, chores, and shopping lists.
MIT ★ 5 updated 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-mcpWhat Hermes Grocy MCP does
This server exposes tools to interact directly with the Grocy household ERP API. It searches inventory items, resolves Grocycodes and barcodes, tracks stock levels, and monitors expiring or missing groceries.
Write tools apply modifications immediately. The assistant can consume supplies, log restocks, manage shopping list entries, check off recurring chores, and update arbitrary entity objects via JSON.
Private setups require GROCY_API_KEY configured in client settings alongside GROCY_BASE_URL. Unauthenticated connections fall back to read-only queries against the public Grocy demo instance.
What it helps with
- check stock levels and find expired food items in Grocy
- add, consume, or inventory grocery supplies
- lookup products by barcode or Grocycode
- mark chores as completed and inspect household tasks
Example prompts for the agent
- Check volatile stock in Grocy and list anything overdue
- Consume 1 unit of milk and update current inventory
- Add eggs and butter to my main shopping list
How to install Hermes Grocy MCP
Platform CLI
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-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from hermes-grocy-mcp <command>
Platform CLI
codex mcp add hermes-grocy-mcp --env GROCY_BASE_URL=<GROCY_BASE_URL> --env GROCY_API_KEY=<GROCY_API_KEY> -- uvx hermes-grocy-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from hermes-grocy-mcp <command>
Config file
{
"mcpServers": {
"hermes-grocy-mcp": {
"command": "uvx",
"args": [
"hermes-grocy-mcp"
],
"env": {
"GROCY_BASE_URL": "<GROCY_BASE_URL>",
"GROCY_API_KEY": "<GROCY_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from hermes-grocy-mcp <command>
Config file
{
"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>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from hermes-grocy-mcp <command>
Platform CLI
gemini mcp add -e GROCY_BASE_URL=<GROCY_BASE_URL> -e GROCY_API_KEY=<GROCY_API_KEY> hermes-grocy-mcp uvx hermes-grocy-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from hermes-grocy-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Hermes Grocy MCP
How to install Hermes Grocy MCP in Claude Code?
Run 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.
What does Hermes Grocy MCP do?
It connects AI tools to Grocy to handle inventory management, shopping lists, chores, and product barcode lookups.
What is required to run Hermes Grocy MCP?
A reachable Grocy instance and a valid GROCY_API_KEY environment variable for mutation requests.