Grocy (Home ERP) MCP for AI. Manage inventory, recipes, and chores instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Grocy (Home ERP) MCP connects your self-hosted household management system to any AI client. Use it to track pantry inventory, manage grocery lists, organize chores, and plan meals through conversation.
It lets you know exactly what supplies you're running low on or if a recipe is even possible tonight.
What your AI can do
Add product stock
Increase the count of a specific product in your inventory.
Add shopping list item
Add one or more items to the list of groceries you need to buy.
Charge battery
Mark a battery as having been fully charged and ready for use.
You can list all products currently in your pantry or check the current stock level of a specific item.
The agent adds new items, removes purchased ones, or retrieves everything you still need to buy.
It lets you view recipes and automatically subtracts all necessary ingredients from your current stock count when a meal is cooked.
You can retrieve pending household chores, create new to-dos, or mark maintenance items as completed.
The system allows you to add stock for new products or transfer existing supplies between storage locations.
Ask an AI about this
Waiting for input…
Grocy (Home ERP): 21 Tools for Household Management
Use these tools to control every aspect of your home life, from tracking pantry stock levels to completing maintenance tasks.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Grocy (Home ERP) on VinkiusAdd Product Stock
Increase the count of a specific product in your inventory.
Add Shopping List Item
Add one or more items to the list of groceries you need to buy.
Charge Battery
Mark a battery as having been fully charged and ready for use.
Clear Shopping List
Remove every item from your current shopping list, typically after you've bought...
Consume Product Stock
Decrease the stock amount for a product because it was used or consumed.
Consume Recipe
Automatically deducts all required ingredients from your pantry when you decide to cook a meal.
Create Task
Adds a brand new, specific chore or task to your household to-do list.
Delete Task
Removes an existing, unnecessary chore or general task from the system records.
Execute Chore
Marks a pending household chore as completed so it disappears from your list.
Get Batteries
Lists all batteries currently tracked in the system, including their status.
Get Chores
Retrieves a full list of household chores that still need attention.
Get Product
Fetches detailed information about one specific product by its ID or name.
Get Recipe
Gets the full details, including ingredients, for a single recipe you want to make.
Get Recipes
Retrieves a list of all available recipes in your collection.
Get Shopping List
Displays every item currently sitting on your shopping list.
Get Stock
Shows a comprehensive list of all products and their current count in the pantry.
Get Tasks
Retrieves a full, organized list of general household tasks and reminders.
Inventory Product Stock
Sets or resets the total stock amount for any given product to a defined number.
Remove Purchased Shopping List
Clears all items from your shopping list that have already been bought at the store.
Transfer Product Stock
Changes a product's location or count by moving it between different storage areas.
Update Task
Modifies the details, due date, or priority of an existing task on your list.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Grocy (Home ERP) integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Grocy (Home ERP), then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Grocy. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 21 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
The chore list always feels like it lives on three different platforms.
Right now, coordinating household logistics means jumping between the grocery app to see what's missing, a physical whiteboard for chores, and your pantry inventory sheet. You copy-paste item counts; you manually check off boxes; you remember which list is the 'real' one.
With this MCP, everything is conversational. Your agent handles all of that mess behind the scenes. It reads your Grocy data instantly and gives you a single, cohesive answer to any question about what needs doing or buying.
Grocy (Home ERP) lets you manage inventory, list items & chores.
You no longer have to manually update stock levels every time the family eats. The system handles it. You use `consume_product_stock` implicitly just by asking to cook a meal, and the agent takes care of deducting ingredients via `consume_recipe`.
It's automatic, always up-to-date data in one conversation. It’s a massive change from keeping three separate pieces of paper on the fridge.
What your AI can actually do with this
This connector gives your agent full control over your home’s operational data. Instead of jumping between multiple apps—one for inventory, one for lists, another for chores—you just talk to it. Your AI client acts like a personal manager, reading your Grocy data and handling the logistics. Need to know if you have enough eggs for breakfast? Just ask.
Want to add milk to the list while standing in the store? Tell your agent. It manages everything from consuming ingredients when you cook to marking chores as done. Because it's hosted through Vinkius, you connect once from any MCP-compatible client and get instant access to this entire suite of home tools.
019e38a4-6115-72c4-8859-70df4e05c786 
Here's how it actually works
The bottom line is you talk to a single interface that manages all of your household logistics.
Subscribe to the Grocy MCP and provide your API Key and Base URL.
Your AI agent accesses the connection, giving it read/write permissions for your home data.
You interact with your agent using natural language commands (e.g., 'What do I need for lasagna?').
Who is this actually for?
This MCP is for anyone whose daily life involves managing physical resources and coordinating shared tasks. If you're tired of keeping multiple spreadsheets or apps open just to manage groceries, chores, and pantry counts—you need this.
Manages grocery runs by adding items via add_shopping_list_item and ensuring no chore falls through the cracks using get_chores.
Plans meals by checking ingredient availability with get_stock and automatically deducting ingredients for recipes using consume_recipe.
Keeps track of maintenance tasks, managing both pending chores (get_chores) and general to-dos via the create_task tool.
What Changes When You Connect
Stop guessing if you have enough ingredients. By calling get_stock or using the agent to check your pantry, you know exactly what’s available before starting dinner prep.
Never forget an item on a grocery run. The MCP lets you manage your list by adding items with add_shopping_list_item and clearing out purchased goods with remove_purchased_shopping_list.
Meal planning just got smart. When you cook, the system runs consume_recipe, automatically draining ingredients from stock so you never over-purchase or realize a vital component is missing.
Keep household maintenance organized. You can retrieve pending chores with get_chores and then mark them done immediately using execute_chore. It’s simple accountability.
Full control over your data, no vendor lock-in. Since this MCP connects to your self-hosted Grocy instance via Vinkius, you keep all the data where it belongs—with you.
See it in action
The End-of-Month Pantry Audit
The user asks their agent: 'What supplies do we need to buy next month?' The agent runs get_stock, finds low counts, and generates a preliminary shopping list using add_shopping_list_item.
Dinner Dilemma
The user says: 'What can we make tonight with what's in stock?' The agent checks recipes via get_recipes, identifies a match, and then confirms the ingredients are available by checking get_stock.
Post-Grocery Cleanup
The user asks: 'I finished shopping. Update my lists.' The agent first runs remove_purchased_shopping_list, clearing purchased items, and then optionally calls add_product_stock for bulk goods.
Catching Up on Life Admin
The user asks: 'Show me what's pending in the house.' The agent displays all chores via get_chores, and upon confirmation, marks a chore as done using execute_chore.
The honest tradeoffs
Treating it like a simple database query
Asking the agent just for 'Milk stock' when you actually need to know if you have enough milk to make pancakes, which requires checking ingredients and recipes.
Don't ask for raw data. Ask: 'Can we make pancakes?' The agent will then use get_recipes and check get_stock simultaneously to give a useful answer.
Manually updating multiple lists
Updating the pantry, creating a chore list, and making a separate shopping list entry in three different places.
Use the agent as a single source of truth. Say: 'We used 4 eggs for breakfast.' The agent handles consume_product_stock without you needing to remember which tool to call.
Forgetting about task updates
A chore was moved from this week to next, but the user has no way to tell the system.
Don't just ignore it. Use update_task to adjust the due date or priority of a general household item.
When It Fits, When It Doesn't
Use this MCP if your home management involves tracking consumption and dependencies (e.g., cooking requires ingredients, chores need completing). If you only need simple reminders—like 'Call dentist next week'—you can just use the standard task tools. But if you need to track what is consumed from a finite resource like canned goods or cleaning supplies, this MCP’s stock tracking and recipe consumption tools (get_stock and consume_recipe) are necessary. If your data exists in another system (like an accounting ledger), you'll need a different category of connector, not just home management.
Questions you might have
How does Grocy (Home ERP) MCP handle ingredients for recipes? +
The agent checks your stock using get_stock and, when you confirm a meal, it automatically deducts all used items by calling consume_recipe. You don't have to update anything manually.
Can I use Grocy (Home ERP) MCP to manage my shopping list? +
Yep. The agent lets you add things with add_shopping_list_item and clear the list entirely once you've done your shopping using clear_shopping_list.
What if I move product stock locations? +
You don't need to update multiple records. Use the transfer_product_stock tool, and the agent manages moving the count between different defined storage areas.
Does Grocy (Home ERP) MCP track general tasks or just chores? +
It tracks both. You can use get_chores for maintenance items, but you also have the ability to create and manage general to-dos using create_task.
When I use the add_product_stock tool, what format does the Grocy API key need? +
The MCP requires a read/write API key with full inventory permissions. You must ensure this key is generated within your Grocy settings and passed to Vinkius during setup. It's crucial that the key has proper scope access for stock modification.
If I try to consume product stock using consume_product_stock, what prevents negative inventory? +
The tool checks current levels before execution and will throw an error if consumption exceeds available stock. This built-in validation protects your data integrity, preventing you from recording items that don't exist physically.
How can I query the get_stock tool to find only low-level supplies? +
You must pass specific filtering parameters to the API call. While basic calls list everything, you can specify a minimum threshold (e.g., quantity < 5) in your prompt's context for accurate results.
Is there a rate limit when using get_tasks or updating tasks frequently? +
The API handles high request volumes, but excessive calls within seconds may trigger throttling. For continuous monitoring, consider batching your task checks into single workflows rather than rapid succession.
Can I update the stock level of a product if the current count is wrong? +
Yes! You can use the inventory_product_stock tool to set a specific new amount, or add_product_stock to increase the current count by a specific value.
How do I mark a household chore as completed? +
Simply use the execute_chore tool with the specific Chore ID. This will record the execution time and update the next scheduled date in Grocy.
Can I see what ingredients I need to buy for my recipes? +
You can use get_recipe to see the required ingredients for a specific dish, and then use get_shopping_list to see if they are already listed for purchase.
We've already built the connector for Grocy (Home ERP). Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 21 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.