Spree Commerce: open-source B2B and marketplace ecommerce
Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
Description from the maker (original English)
MCP server for Grocy household ERP inventory and shopping workflows.
These three are never merged into one score: opinions, measurements and popularity are different things.
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
GROCY_BASE_URL, GROCY_API_KEYValues marked secret are keys to your account. Never share them or paste them into a chat.
You need
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json
{
"mcpServers": {
"hermes-grocy": {
"command": "uvx",
"args": [
"hermes-grocy-mcp"
],
"env": {
"GROCY_BASE_URL": "your-value",
"GROCY_API_KEY": "your-value"
}
}
}
}Run this in your terminal
claude mcp add hermes-grocy --env GROCY_BASE_URL=your-value --env GROCY_API_KEY=your-value -- uvx hermes-grocy-mcpFill in the empty values before running it.
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"hermes-grocy": {
"command": "uvx",
"args": [
"hermes-grocy-mcp"
],
"env": {
"GROCY_BASE_URL": "your-value",
"GROCY_API_KEY": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Paste into .vscode/mcp.json in your project
{
"servers": {
"hermes-grocy": {
"type": "stdio",
"command": "uvx",
"args": [
"hermes-grocy-mcp"
],
"env": {
"GROCY_BASE_URL": "your-value",
"GROCY_API_KEY": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.
Your choice stays on this device in a cookie; no account needed.
GROCY_BASE_URL envThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026
The registry name was verified with the GitHub account rusty4444, which owns the repo
We have not read this repo from GitHub yet
We have not read this repo from GitHub yet
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: GROCY_API_KEY
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed –, and the latest version (0.2.1) reached the registry 6 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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:
/api/objects/{entity} entityGrocy 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.
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 .
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.
{
"mcpServers": { "grocy": { "command": "grocy-mcp", "env": { "GROCY_BASE_URL": "https://grocy.example.com", "GROCY_API_KEY": "your-api-key" } } } }
| 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 |
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.
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.