MCP server and CLI for Grocy with workflow tools, planning helpers, and household automation surfaces
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"grocy-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# grocy-mcp [](https://pypi.org/project/grocy-mcp/) [](https://pypi.org/project/grocy-mcp/) [](https://github.com/moustafattia/grocy-mcp/actions/workflows/ci.yml) [](https://github.com/moustafattia/grocy-mcp/blob/main/LICENSE) Python MCP server and CLI for [Grocy](https://grocy.info/). `grocy-mcp` lets AI agents and terminal users work with Grocy through one shared codebase. It exposes stock, shopping lists, recipes, chores, batteries, equipment, calendar exports, file groups, print helpers, workflow preview/apply helpers, discovery tools, and generic entity management through: - an MCP server for tools like Claude Desktop, Claude Code, and other MCP clients - a `grocy` CLI for direct command-line use ## Choose your path - Want to connect Grocy to Claude, ChatGPT, or another MCP client? Install `grocy-mcp`, run the MCP server, and point your client at it. - Want to manage Grocy from the terminal? Install the package and use the `grocy` CLI directly. - Want to build chat, OCR, or photo-driven flows? Normalize items outside this repo, then call the workflow preview/apply tools here. If you only want the fastest possible first run, this is enough: ```bash pip install grocy-mcp export GROCY_URL="https://grocy.example.com" export GROCY_API_KEY="your-api-key-here" grocy stock overview ``` ## Why this project Grocy already has a solid REST API, but most day-to-day interactions still require either: - clicking through the Grocy UI - writing one-off API scripts - wiring ad hoc automations around numeric IDs `grocy-mcp` packages those API capabilities into a cleaner operator experience: - human-friendly names instead of IDs for common flows - a reusable MCP surface for AI agents - a mirrored CLI for shell workf…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.