Grocy
Grocy · Shopping and household
Self-hosted home inventory: stock, shopping lists, recipes, chores and batteries
The client pastes their API key from Grocy's settings. We store it encrypted.
Building with Grocy? The docs have setup steps and code for every tool.
Open the Grocy docsTools
Your agent calls any endpoint of Grocy's API with the request tool, with the client's access attached.
Base URL for request
https://{host}/api
request
HTTPS ANY /v1/clients/{clientId}/grocy/{path}
Any endpoint of Grocy's own API, with the client's access attached.
- servicestringrequired
- This service: grocy
- methodstringrequired
- GET, POST, PUT, PATCH or DELETE
- pathstringrequired
- The path under https://{host}/api
- queryobjectoptional
- Query parameters
- bodyobjectoptional
- A JSON body
Over MCP every tool also takes client_id, from list_clients. Over HTTPS send it as clientId to https://api.operate.as/v1.
What the client approves
- Use the Grocy key you paste, with only the access you gave that key
Get started
Send your next client one link
Add a client, select the services, copy the link. You'll get an email the moment their access is ready. Start free, no card required. Paid plans are one flat monthly price, and a busy month never takes your agents offline.