Hermes Grocy MCP

A Model Context Protocol (MCP) server for Grocy, the self-hosted household ERP for groceries, inventory, chores, batteries, recipes, tasks, and shopping lists. Its 25 documented tools cover grocy, product, stock, shopping. It runs locally over stdio via the published package.

People connecting e-commerce tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-01 · ★ 2 · #26 OF 39 MAINTAINED E-COMMERCE · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Hermes Grocy MCP

before you install - you'll need

Set GROCY_BASE_URL, GROCY_API_KEY before connecting.

Claude Code

claude mcp add rusty4444-grocy-mcp -- uvx hermes-grocy-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "rusty4444-grocy-mcp": {
      "command": "uvx",
      "args": [
        "hermes-grocy-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package hermes-grocy-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.rusty4444 is GitHub-verified and matches the repo owner

03 · What Hermes Grocy MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list configured products, search products by name/description, fetch one product object, and resolve a barcode/Grocycode.

The 25 tools it gives your agent

Extracted from the project's README - what Hermes Grocy MCP lets an agent do.

grocy_system_info: - Grocy version and runtime details
grocy_list_products: - List configured products
grocy_search_products: - Search products by name/description
grocy_get_product: - Fetch one product object
grocy_lookup_product_by_barcode: - Resolve a barcode/Grocycode
grocy_stock_overview: - Current stock rows
grocy_volatile_stock: - Due, overdue, expired, or missing products
grocy_product_stock_details: - Detailed stock state for one product
grocy_product_stock_entries: - Individual stock entries in next-use order
grocy_common_entities: - Common generic entity names useful with CRUD tools
grocy_list_shopping_lists: - Configured shopping lists
grocy_list_shopping_list_items: - Current shopping list rows, optionally filtered by list id

show all 25 tools

grocy_list_entity: - List any generic Grocy entity
grocy_get_entity_object: - Fetch any generic entity object
grocy_create_entity_object: - POST a generic entity object from JSON
grocy_update_entity_object: - PUT a generic entity object from JSON
grocy_add_stock: - Add product amount to stock
grocy_consume_stock: - Consume/remove product amount from stock
grocy_inventory_product: - Set product inventory amount
grocy_add_product_to_shopping_list: - Add a product to a shopping list
grocy_remove_product_from_shopping_list: - Remove a product from a shopping list
grocy_set_userfields: - Set userfield values on an entity object
grocy_list_chores: - List chores including computed next-due times
grocy_execute_chore: - Execute (mark done) a chore, optionally backdated
grocy_list_tasks: - List tasks

04 · Who maintains Hermes Grocy MCP

Hermes Grocy MCP is maintained by rusty4444. We track 4 MCP servers from rusty4444 - 4 actively maintained, 5 combined GitHub stars, oldest repo from May 2026. Full record: all servers from rusty4444.

wallabag MCP MCP server for wallabag read-it-later entries, tags, and annotations. ★ 2

05 · Facts

repository: github.com/rusty4444/grocy-mcp
website: https://github.com/rusty4444/grocy-mcp
category: e-commerce - ranked #26 of 39 actively-maintained e-commerce servers as of 2026-08-25.
registry: io.github.rusty4444/hermes-grocy-mcp (active, first published 2026-05-18)
packages: pypi:hermes-grocy-mcp

06 · Hermes Grocy MCP FAQ

Is Hermes Grocy MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-01. We re-verify nightly.

What can Hermes Grocy MCP do?

With this server connected, an agent can list configured products, search products by name/description, fetch one product object, and resolve a barcode/Grocycode.

How do I install Hermes Grocy MCP?

Run `uvx hermes-grocy-mcp`. The README documents 2 environment variables (GROCY_BASE_URL, GROCY_API_KEY) to set first. Set GROCY_BASE_URL, GROCY_API_KEY before connecting. You can also paste the ready-made client config above.

Does Hermes Grocy MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Hermes Grocy MCP

Alternatives to Hermes Grocy MCP

Maintained e-commerce servers if Hermes Grocy MCP isn't the fit.

More e-commerce MCP servers · Kronan MCP · Appstore Connect · CrowdStrike MCP · Level MCP

More Python MCP servers · wallabag MCP · Cronometer API MCP · Inbody API MCP · Rachio MCP · Agent Harnesses · see all