{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_jtmve2vfbvf3","handle":"grocy-mcp","url":"https://wellknown.network/agents/grocy-mcp","links":{"self":"https://wellknown.network/agents/grocy-mcp/record.json","html":"https://wellknown.network/agents/grocy-mcp","markdown":"https://wellknown.network/agents/grocy-mcp/record.md","api":"https://wellknown.network/api/v1/agents/grocy-mcp","status":"https://wellknown.network/api/v1/agents/grocy-mcp/status","claim":"https://wellknown.network/agents/grocy-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/grocy-mcp/claim.json","badge":"https://wellknown.network/agents/grocy-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/grocy-mcp/history","tools":"https://wellknown.network/api/v1/agents/grocy-mcp/tools"},"ard":{"identifier":"urn:air::server:grocy-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"grocy-mcp","summary":"MCP server and CLI for Grocy with workflow tools, planning helpers, and household automation surfaces","description":"# grocy-mcp\n\n[![PyPI](https://img.shields.io/pypi/v/grocy-mcp)](https://pypi.org/project/grocy-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/grocy-mcp)](https://pypi.org/project/grocy-mcp/)\n[![CI](https://github.com/moustafattia/grocy-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/moustafattia/grocy-mcp/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/moustafattia/grocy-mcp/blob/main/LICENSE)\n\nPython MCP server and CLI for [Grocy](https://grocy.info/).\n\n`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:\n\n- an MCP server for tools like Claude Desktop, Claude Code, and other MCP clients\n- a `grocy` CLI for direct command-line use\n\n## Choose your path\n\n- Want to connect Grocy to Claude, ChatGPT, or another MCP client? Install `grocy-mcp`, run the MCP server, and point your client at it.\n- Want to manage Grocy from the terminal? Install the package and use the `grocy` CLI directly.\n- Want to build chat, OCR, or photo-driven flows? Normalize items outside this repo, then call the workflow preview/apply tools here.\n\nIf you only want the fastest possible first run, this is enough:\n\n```bash\npip install grocy-mcp\nexport GROCY_URL=\"https://grocy.example.com\"\nexport GROCY_API_KEY=\"your-api-key-here\"\ngrocy stock overview\n```\n\n## Why this project\n\nGrocy already has a solid REST API, but most day-to-day interactions still require either:\n\n- clicking through the Grocy UI\n- writing one-off API scripts\n- wiring ad hoc automations around numeric IDs\n\n`grocy-mcp` packages those API capabilities into a cleaner operator experience:\n\n- human-friendly names instead of IDs for common flows\n- a reusable MCP surface for AI agents\n- a mirrored CLI for shell workf…","publisher":{"name":"Moustafa Attia","url":null},"homepage":"https://github.com/moustafattia/grocy-mcp","repository":"https://github.com/moustafattia/grocy-mcp","version":"0.2.0","license":null,"protocols":["mcp"],"tags":["ai-agents","cli","grocy","home-automation","mcp"],"pricing":null,"endpoints":[{"url":"pypi:grocy-mcp","type":"package_pypi","auth":null,"probeable":false,"listed":true}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"grocy-mcp","registry":"pypi","observedAt":"2026-11-09T06:27:47.891Z","publishedAt":"2026-04-01T06:01:29.593671Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"grocy-mcp","url":"https://pypi.org/project/grocy-mcp/","firstSeenAt":"2026-09-09T16:24:59.426Z","fetchedAt":"2026-11-09T06:26:21.659Z","normalizedAt":"2026-11-09T06:26:21.659Z"}]},"firstSeenAt":"2026-09-09T16:24:59.426Z","updatedAt":"2026-11-09T06:27:47.891Z"}