Hermes Grocy MCP

MCP server for Grocy household ERP inventory and shopping workflows.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for Hermes Grocy MCP, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Documentation Overview

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

bash

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

Or from a checkout:

bash

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

Configuration

The server reads configuration from environment variables:

Variable	Required	Default	Description
`GROCY_BASE_URL`	No	`https://demo.grocy.info`	Grocy base URL, with or without `/api`
`GROCY_API_KEY`	No for public/demo read-only instances, yes for private/write access	unset	Grocy API key sent as `GROCY-API-KEY`
`GROCY_TIMEOUT`	No	`20`	HTTP timeout in seconds

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

MCP client config

config.json

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

Tools

Tool	Purpose
`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
`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

Development and validation

bash

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

The live read-only test defaults to https://demo.grocy.info, avoiding mutations on shared infrastructure. It has been validated against Grocy API 4.6.0. Use a private Grocy instance plus GROCY_API_KEY for write-path testing.

Safety

Write-capable tools directly mutate Grocy data. Prefer read-only tools when using public demos. Keep GROCY_API_KEY in MCP client environment config or a secret manager, never in source control.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Hermes Grocy MCP

We don't have a confirmed install command for Hermes Grocy MCP yet, so we don't publish a generated one — a guessed package name would point at the wrong package or none at all. Follow the project's own README or setup instructions (https://github.com/rusty4444/grocy-mcp) for the current steps.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Hermes Grocy MCP AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/hermes-grocy-mcp?style=directory)](https://allmcps.com/mcp/hermes-grocy-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/hermes-grocy-mcp"><img src="https://allmcps.com/api/badge/hermes-grocy-mcp?style=directory" alt="Hermes Grocy MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

31Quality signal: Emerging · 31/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools11/30

Adoption & activity2/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Hermes Grocy MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Documentation Overview

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

Installation

bash

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

Or from a checkout:

bash

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

Configuration

The server reads configuration from environment variables:

Variable	Required	Default	Description
`GROCY_BASE_URL`	No	`https://demo.grocy.info`	Grocy base URL, with or without `/api`
`GROCY_API_KEY`	No for public/demo read-only instances, yes for private/write access	unset	Grocy API key sent as `GROCY-API-KEY`
`GROCY_TIMEOUT`	No	`20`	HTTP timeout in seconds

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

MCP client config

config.json

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

Tools

Tool	Purpose
`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
`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

Development and validation

bash

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

Safety

Write-capable tools directly mutate Grocy data. Prefer read-only tools when using public demos. Keep GROCY_API_KEY in MCP client environment config or a secret manager, never in source control.

Frequently Asked Questions about Hermes Grocy MCP