Grocy MCP Server
Allows AI agents to manage a Grocy instance, including pantry stock and expiry dates, shopping lists, recipes, meal plans, products, quantity-unit conversions, purchases, consumption, opening, and transfers.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Grocy MCP Server
An MCP (Model Context Protocol) server that lets AI agents manage a Grocy instance through natural language: pantry stock, expiry dates, shopping lists, recipes and meal plans. Ships as a Home Assistant add-on and also runs standalone.
Status: experimental (0.x). Expect breaking changes.
Features
Inventory — view stock by location, find expiring items, log purchases, consumption, opening and transfers
Shopping list — view, add, remove, add a recipe's missing ingredients
Recipes — search, check fulfillment against stock, create and edit, add ingredients, upload images, consume a cooked recipe
Meal plan — view, add and remove entries
Product database — create and update products, quantity-unit conversions, Open Food Facts lookup
Tools accept human-readable names and resolve them to Grocy IDs. Ambiguous matches are surfaced instead of guessed.
Related MCP server: grocy-mcp
Installation
Home Assistant add-on
In Home Assistant go to Settings → Add-ons → Add-on Store → ⋮ → Repositories and add:
https://github.com/rabefabi/grocy-mcpInstall Grocy MCP Server, set
grocy_urlandgrocy_api_token, start it.
Option | Required | Description |
| yes | Base URL of your Grocy instance, e.g. |
| yes | API key from Grocy (Settings → Manage API keys) |
| no |
|
The add-on publishes no port by default, because the MCP endpoint has no authentication. DOCS.md describes how to connect a client: by enabling port 8001 or through nginx with TLS and a token.
Docker (standalone)
cp .env.example .env # set GROCY_URL, GROCY_API_TOKEN and MCP_BEARER_TOKEN
docker compose -f docker-compose.grocy-mcp-standalone.yml --env-file .env up -d --buildThe MCP server has no authentication of its own, so the compose file puts
Caddy in front of it (Caddyfile.standalone).
Only Caddy's HTTPS port is published; the MCP server's port stays inside the
Docker network. Caddy
terminates TLS. By default the certificate comes from Caddy's own CA, so a client either trusts that CA (
docker compose -f docker-compose.grocy-mcp-standalone.yml cp caddy:/data/caddy/pki/authorities/local/root.crt .) or skips certificate verification. WithMCP_TLSset to an email address andMCP_SITE_ADDRESSto a public domain that points at the host, Caddy gets a public certificate instead; this needsMCP_HTTPS_PORT=443.rejects requests without
Authorization: Bearer <MCP_BEARER_TOKEN>with401. The token has no default; generate one withopenssl rand -hex 32.rejects clients outside private networks with
403.MCP_ALLOWED_IPStakes other ranges, in Caddy'sremote_ipsyntax.
The endpoint is https://<MCP_SITE_ADDRESS>:<MCP_HTTPS_PORT>/mcp, by default
https://localhost:8443/mcp.
Local (development)
cp .env.example .env
uv sync
just grocy-mcp-run staging # runs against the Grocy in .envVariable | Required | Description |
| yes | Base URL of your Grocy instance (no trailing slash) |
| yes | API key from Grocy |
| no |
|
| no | Port the server listens on (default |
Connecting an MCP client
The server speaks Streamable HTTP at http://<host>:<port>/mcp. A health endpoint is at /health.
Example client config for the standalone Docker setup:
{
"mcpServers": {
"grocy": {
"type": "http",
"url": "https://<host>:8443/mcp",
"headers": { "Authorization": "Bearer <MCP_BEARER_TOKEN>" }
}
}
}The server itself has no client authentication: put it behind a proxy that checks a token (Caddy in the standalone setup, nginx for the add-on, see DOCS.md) or only expose it inside a trusted network.
Skills
skills/ contains skill documents (SKILL.md) that teach an AI agent the right tool sequences for each workflow: inventory, shopping list, recipe discovery, recipe import, meal planning, product management and a household profile. Load them into your MCP client alongside the server.
Development
Requires Docker, just and uv with Python 3.13+. Run just to list all recipes.
just grocy-up # start a local Grocy test instance (http://localhost:9283, admin/admin)
just grocy-token # write an API key to .env.grocy.test
just grocy-seed # load representative test data
just grocy-test # run the test suite (extra args are passed to pytest)
just grocy-down # remove the test instance
just typecheck # type-check src/ with pyrightSee CLAUDE.md for project structure and conventions, and docs/adr/ for architecture decisions.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Scraps Kitchen gives any AI agent a persistent, household-aware kitchen memory. Unlike generic chatbot recall, Scraps maintains structured cooking data: what's in your fridge (with freshness tracking), who you cook for (with allergens, dietary restrictions, and preferences), your recipe collection (with cook notes and per-diner ratings), your shopping list, and your kitchen equipment. 27 tools across 6 domains let agents read kitchen context, suggest meals that respect dietary safety, update the pantry after cooking, and build a history of what works for your household. Every interaction makes the data richer. Cooking history, preference signals, kitchen awareness = better suggestions next time. All tools work via oAuth and a free scraps.kitchen account.
Recipe search, ingredient matching, nutrition filters and a private cookbook for any AI agent.
AI-powered kitchen management — pantry, recipes, meal plans, shopping lists
Household meal planning: recipes, weekly meal plans, and grocery lists for your AI agent.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables interaction with Grocy's API through MCP, allowing management of grocery inventory, shopping lists, and household tasks via natural language.203 npm28MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage household operations including groceries, inventory, chores, recipes, and shopping lists through the Grocy self-hosted ERP system.5MIT
- AlicenseCqualityCmaintenanceEnables AI agents and terminal users to manage Grocy household inventory, shopping lists, recipes, chores, and related household operations through MCP tools and a command-line interface.89MIT
- AlicenseBqualityBmaintenanceEnables AI agents to manage recipes, meal plans, shopping lists, recipe imports, Bring! grocery sync, Mercadona price lookups, and optional nutrition using a self-hosted Mealie instance.24AGPL 3.0