Hermes Grocy MCP

Name: Hermes Grocy MCP
Author: rusty4444

de rusty4444versión 0.2.1i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.rusty4444/hermes-grocy-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

MCP server for Grocy household ERP inventory and shopping workflows.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Tiendas en línea y pagos
Debes completar: GROCY_API_KEY

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: GROCY_BASE_URL, GROCY_API_KEY

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "hermes-grocy": {
      "command": "uvx",
      "args": [
        "hermes-grocy-mcp"
      ],
      "env": {
        "GROCY_BASE_URL": "your-value",
        "GROCY_API_KEY": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add hermes-grocy --env GROCY_BASE_URL=your-value --env GROCY_API_KEY=your-value -- uvx hermes-grocy-mcp

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "hermes-grocy": {
      "command": "uvx",
      "args": [
        "hermes-grocy-mcp"
      ],
      "env": {
        "GROCY_BASE_URL": "your-value",
        "GROCY_API_KEY": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "hermes-grocy": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hermes-grocy-mcp"
      ],
      "env": {
        "GROCY_BASE_URL": "your-value",
        "GROCY_API_KEY": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

GROCY_BASE_URL env
Grocy base URL, with or without /api
GROCY_API_KEY secreto env
Grocy API key for private instances or write access

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 8 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub rusty4444, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Tiendas en línea y pagosi

Más estrellas que el 0% de los otros 2550 servidores de esta categoría
Publicado en el registro más recientemente que el 8% de los otros 2550 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 2550 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Hermes Grocy MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: GROCY_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.2.1) llegó al registro hace 6 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spree Commerce: open-source B2B and marketplace ecommerce

de spree

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

Se ejecuta en la nube★ 15.812BSD-3-ClauseActualizado hace 8 días

Instalar

Stripe MCP

de stripe

MCP server integrating with Stripe - tools for customers, products, payments, and more.

Se ejecuta en la nube★ 2043MITActualizado hace 12 meses

Instalar

MCP Cn Commerce

de TonyWang-hub

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

Se ejecuta en tu computadora★ 96MITActualizado hace 29 días

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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:

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

"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

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.

Hermes Grocy MCP

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Tiendas en línea y pagosi

Preguntas frecuentes

Alternativas

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

README del creador

Grocy MCP

Why this exists

Installation

Configuration

MCP client config

Tools

Development and validation

Safety