Hermes Grocy MCP
Connects to Grocy, the self-hosted household ERP, and exposes its REST API as MCP tools for stock, shopping lists, and product lookups. You get read operations like searching products, checking volatile stock, and scanning barcodes, plus write actions to add or consume inventory and manage shopping lists. The tool surface is deliberately small and explicit, covering the awkward household workflows that generic REST clients make clunky. Built for Claude Desktop, Hermes, and Cursor against Grocy API 4.6.0. Reach for this when you want conversational access to your pantry inventory or need an AI to help manage grocery runs without clicking through the Grocy web UI.
- tools
- 25
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- May 18, 2026
Tools
25 toolsPublic tool metadata for what this MCP can expose to an agent.
grocy_system_infoGrocy version and runtime details
Grocy version and runtime details
No parameter schema in public metadata yet.
grocy_list_productsList configured products
List configured products
No parameter schema in public metadata yet.
grocy_search_productsSearch products by name/description
Search products by name/description
No parameter schema in public metadata yet.
grocy_get_productFetch one product object
Fetch one product object
No parameter schema in public metadata yet.
grocy_lookup_product_by_barcodeResolve a barcode/Grocycode
Resolve a barcode/Grocycode
No parameter schema in public metadata yet.
grocy_stock_overviewCurrent stock rows
Current stock rows
No parameter schema in public metadata yet.
grocy_volatile_stockDue, overdue, expired, or missing products
Due, overdue, expired, or missing products
No parameter schema in public metadata yet.
grocy_product_stock_detailsDetailed stock state for one product
Detailed stock state for one product
No parameter schema in public metadata yet.
grocy_product_stock_entriesIndividual stock entries in next-use order
Individual stock entries in next-use order
No parameter schema in public metadata yet.
grocy_common_entitiesCommon generic entity names useful with CRUD tools
Common generic entity names useful with CRUD tools
No parameter schema in public metadata yet.
grocy_list_shopping_listsConfigured shopping lists
Configured shopping lists
No parameter schema in public metadata yet.
grocy_list_shopping_list_itemsCurrent shopping list rows, optionally filtered by list id
Current shopping list rows, optionally filtered by list id
No parameter schema in public metadata yet.
grocy_list_entityList any generic Grocy entity
List any generic Grocy entity
No parameter schema in public metadata yet.
grocy_get_entity_objectFetch any generic entity object
Fetch any generic entity object
No parameter schema in public metadata yet.
grocy_create_entity_objectPOST a generic entity object from JSON
POST a generic entity object from JSON
No parameter schema in public metadata yet.
grocy_update_entity_objectPUT a generic entity object from JSON
PUT a generic entity object from JSON
No parameter schema in public metadata yet.
grocy_add_stockAdd product amount to stock
Add product amount to stock
No parameter schema in public metadata yet.
grocy_consume_stockConsume/remove product amount from stock
Consume/remove product amount from stock
No parameter schema in public metadata yet.
grocy_inventory_productSet product inventory amount
Set product inventory amount
No parameter schema in public metadata yet.
grocy_add_product_to_shopping_listAdd a product to a shopping list
Add a product to a shopping list
No parameter schema in public metadata yet.
grocy_remove_product_from_shopping_listRemove a product from a shopping list
Remove a product from a shopping list
No parameter schema in public metadata yet.
grocy_set_userfieldsSet userfield values on an entity object
Set userfield values on an entity object
No parameter schema in public metadata yet.
grocy_list_choresList chores including computed next-due times
List chores including computed next-due times
No parameter schema in public metadata yet.
grocy_execute_choreExecute (mark done) a chore, optionally backdated
Execute (mark done) a chore, optionally backdated
No parameter schema in public metadata yet.
grocy_list_tasksList tasks
List tasks
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GROCY_BASE_URLGrocy base URL, with or without /api
GROCY_API_KEYsecretGrocy API key for private instances or write access
Readme
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
Details
- Repository
- github.com/rusty4444/grocy-mcp
- Website
- github.com/rusty4444/grocy-mcp
- Package
hermes-grocy-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active