MCP.Market

Hermes Grocy MCP server

by rusty4444·io.github.rusty4444/hermes-grocy-mcp·v0.2.1·3 stars
No reviews yet

MCP server for Grocy household ERP inventory and shopping workflows.

B78/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
Growing

3 stars19 downloads/wk

Reviews

Write one

Nobody has reviewed Hermes Grocy MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Hermes Grocy MCP tools (21, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • grocy_add_product_to_shopping_list

    Add a product amount to a Grocy shopping list.

  • grocy_add_stock

    Add an amount of a product to Grocy stock.

  • grocy_common_entities

    List common Grocy generic entity names for use with grocy_list_entity and CRUD tools.

  • grocy_consume_stock

    Consume/remove an amount of a product from Grocy stock.

  • grocy_create_entity_objectwrite action

    Create a Grocy generic entity object from a JSON payload.

  • grocy_get_entity_object

    Get any Grocy generic entity object by id.

  • grocy_get_product

    Get one Grocy product object by id.

  • grocy_inventory_product

    Set the inventory amount for a Grocy product.

  • grocy_list_entity

    List any Grocy generic entity exposed by /api/objects/{entity}.

  • grocy_list_products

    List products configured in Grocy.

  • grocy_list_shopping_list_items

    List current Grocy shopping list items.

  • grocy_list_shopping_lists

    List configured Grocy shopping lists.

  • grocy_lookup_product_by_barcode

    Look up a product using Grocy's stock barcode endpoint.

  • grocy_product_stock_details

    Get detailed stock state for one Grocy product.

  • grocy_product_stock_entries

    List individual stock entries for a product in next-use order.

  • grocy_remove_product_from_shopping_listwrite action

    Remove a product amount from a Grocy shopping list.

  • grocy_search_products

    Search Grocy products by name or description.

  • grocy_stock_overview

    Return current Grocy stock rows with amounts and due dates.

  • grocy_system_info

    Return Grocy version and server runtime information.

  • grocy_update_entity_objectwrite action

    Update a Grocy generic entity object from a JSON payload.

  • grocy_volatile_stock

    Return products due soon, overdue, expired, or missing according to Grocy.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan6 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 57 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Hermes Grocy MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 57% of 48,255 servers
Tools
21
the typical server has 7
Tools that change things
14%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
3
more than 80% of 28,688 servers
Downloads a week
19
more than 6% of 12,191 servers with a package

What its tools let an agent do: 18 read · 3 change

Install Hermes Grocy MCP in Claude Code, Cursor or VS Code

claude mcp add hermes-grocy-mcp -- uvx hermes-grocy-mcp
Add to Cursor

What the publisher says

From the Hermes Grocy MCP repository's README, as published. We do not edit it. Read it on GitHub

Grocy MCP

<!-- mcp-name: io.github.rusty4444/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.

This server focuses on AI-friendly household operations that are awkward through generic REST clients:

  • Inspect Grocy system/version status
  • List, search, and inspect products
  • Read current stock, volatile stock, product stock details, and individual stock entries
  • List current shopping list items and add/remove products from shopping lists
  • Look up products by barcode/Grocycode
  • List and inspect any /api/objects/{entity} entity
  • Create/update generic entity objects from JSON
  • Add, consume, and inventory product stock
  • Add/remove product amounts from shopping lists

Why this exists

Grocy has a strong REST API, but MCP coverage is sparse and usually either incomplete or tightly coupled to one client's workflow. This package gives Hermes, Claude Desktop, Cursor, and other MCP clients a small, explicit, documented tool surface.

Installation

pipx install git+https://github.com/rusty4444/grocy-mcp.git

Or from a checkout:

python -m venv .venv
source .venv/bin/activate
pip install -e .

Configuration

The server reads configuration from environment variables:

Grocy API keys are managed in Grocy under Manage API keys. The API accepts the GROCY-API-KEY header.

MCP client config

{
  "mcpServers": {
    "grocy": {
      "command": "grocy-mcp",
      "env": {
        "GROCY_BASE_URL": "https://grocy.example.com",
        "GROCY_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

Development and validation

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
ruff check .
pytest
python scripts/live_readonly_test.py

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Hermes Grocy MCP: common questions

Is Hermes Grocy MCP server safe?
Mostly: it is graded B (78/100). Read the Hermes Grocy MCP safety report
How do I install Hermes Grocy MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Hermes Grocy MCP need an API key?
Yes. The registry entry asks for GROCY_API_KEY.
Is Hermes Grocy MCP maintained?
The last commit was 95 days ago (2026-08-01). The latest release is v0.2.1.
How does Hermes Grocy MCP compare with other MCP servers?
safety score 78/100 (higher than 57% of 48,255 servers); tools 21 (the typical server has 7); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from rusty4444 →