Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What 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-mcp

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>

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.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open