# Grocy MCP for AI Agents AI Agent Connect > Grocy (Home ERP) MCP lets you manage your household inventory, shopping lists, and chores through your AI agent. It connects to your self-hosted Grocy instance so you can check pantry stock, plan meals, and track home maintenance without manual data entry. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/ai-agent-connect - **Tags:** home-automation, pantry-tracker, shopping-list, chore-management, self-hosted ## Description This Connector bridges the gap between your AI agent and your self-hosted Grocy instance, turning your personal home ERP into a conversational interface. Instead of opening a web dashboard to check if you have enough eggs for breakfast or to update your pantry stock, you just ask your agent. It handles the heavy lifting of inventory management, so you can stay organized without the friction of manual data entry. You'll find it's a game changer for keeping a household running smoothly, whether you're tracking recurring chores or managing a complex shopping list. By connecting this to the Vinkius catalog, you get a reliable way to keep your home data in sync with your daily tasks. It handles everything from consuming ingredients for a specific recipe to marking off household maintenance tasks as finished. It's about making your home data accessible and actionable through the tools you already use every day. ## Tools ### charge_battery Mark a household battery as fully charged. Use this to keep track of your home's power status. ### get_batteries See a list of all batteries and their current status. This helps you monitor home power. ### get_chores View all the chores currently assigned to your home. Use this to see what needs doing. ### get_product Look up specific details for an item in your inventory. Use this to check quantities or descriptions. ### get_recipe View the full details of a specific recipe. This helps you see instructions quickly. ### get_recipes See your entire collection of saved recipes. Use this to browse your meal plans. ### get_shopping_list View everything currently on your shopping list. Use this to see what you need to buy. ### get_stock See a full list of every product currently in stock. Use this for a complete pantry overview. ### get_tasks See all tasks currently on your to-do list. Use this to check your current workload. ### inventory_product_stock Set the stock amount of a product to a specific number. Use this to sync your inventory levels. ### transfer_product_stock Move a product from one storage location to another. Use this to track items moving between rooms. ### add_product_stock Add a specific amount of a product to your inventory. Use this to update stock levels after a delivery. ### add_shopping_list_item Put a new item on your grocery shopping list. This helps you keep track of what you need to buy next. ### clear_shopping_list Wipe all items off your current shopping list. This is useful for starting a fresh shopping trip. ### consume_product_stock Subtract a specific amount of a product from your stock. Use this for manual inventory updates. ### consume_recipe Automatically subtract all ingredients for a recipe from your stock. This keeps your pantry accurate after cooking. ### create_task Add a new task to your household to-do list. Use this for one-off projects or reminders. ### delete_task Remove a specific task from your list. Use this to clean up your to-do list. ### execute_chore Mark a household chore as completed. Use this to track recurring maintenance tasks. ### remove_purchased_shopping_list Clear out all items from your list that you've already bought. This helps keep your list clean. ### update_task Edit the details of an existing task. Use this to change dates or descriptions on your to-do list. ## Prompt Examples **Prompt:** ``` What's in my pantry right now? ``` **Response:** ``` I've checked your Grocy inventory. Here is what you currently have in stock: | Item | Quantity | Status | | :--- | :--- | :--- | | Milk (2L) | 2 | In Stock | | Eggs | 12 | In Stock | | Flour (1kg) | 1 | Low Stock | Would you like me to add anything to your shopping list? ``` **Prompt:** ``` I just finished making the spaghetti. Did it update the stock? ``` **Response:** ``` Yes, I've updated your pantry. I used the recipe details to subtract the following from your stock: * **Pasta** (250g) * **Tomato Sauce** (1 jar) * **Ground Beef** (500g) Your inventory is now up to date. ``` **Prompt:** ``` What chores are left for this week? ``` **Response:** ``` You have 3 chores remaining for this week: * **Vacuuming** (Pending) * **Watering Plants** (Pending) * **Dusting** (Pending) Would you like me to mark one of these as finished for you? ``` ## Capabilities ### Update pantry stock levels Adjust the amount of specific items in your inventory instantly. ### Manage grocery shopping lists Add items to your list and clear out things you've already bought. ### Track household chores and tasks View pending chores and mark them as finished with a single command. ### Automate ingredient consumption for recipes Automatically deduct ingredients from your stock when you cook a meal. ### Monitor household battery cycles Track and update the status of your household batteries. ## Use Cases ### Checking for dinner ingredients A user asks if they have chicken. The agent uses get_stock and get_recipe to confirm and tells them they need to buy some. ### Batch shopping A user tells the agent they finished the groceries. The agent uses remove_purchased_shopping_list to clean up the list. ### Chore coordination A partner asks what's left to do. The agent uses get_chores and execute_chore to show the list and update it. ### Inventory transfer A user moves items from the pantry to the fridge. The agent uses transfer_product_stock to update the locations. ## Benefits - Stop guessing what's in your pantry by using get_stock to see your real-time inventory. - Keep your grocery list updated with add_shopping_list_item so you never forget an ingredient. - Save time on meal prep by using consume_recipe to automatically deduct ingredients from your stock. - Stay on top of house maintenance by using execute_chore to mark tasks as finished. - Manage your household electronics by tracking battery cycles with get_batteries and charge_battery. ## How It Works The bottom line is you get a voice or text interface for your entire home inventory and task list. 1. Subscribe to the Grocy MCP on Vinkius. 2. Provide your Grocy API Key and Base URL in your AI client. 3. Ask your agent to check stock, add items to lists, or update chores. ## Frequently Asked Questions **How does Grocy MCP help with my groceries?** It connects your AI agent directly to your Grocy shopping list. You can ask your agent to add items, view your current list, or clear out items you've already bought, making grocery planning much faster. **Can I use Grocy MCP to track my home batteries?** Yes, it can. You can ask your agent to list all your batteries and check their status, or mark them as charged when you're done. **Does Grocy MCP work with my existing Grocy data?** Yes, it's designed to work with your existing self-hosted Grocy instance. You just need to provide your API key and base URL to get started. **How do I use Grocy MCP for meal planning?** You can browse your saved recipes and ask your agent to see what ingredients you need. It can even automatically deduct those ingredients from your stock once you've finished cooking. **Can Grocy MCP manage my household chores?** Absolutely. It can list all your pending chores and let you mark them as executed through a simple conversation with your AI agent. **Is Grocy MCP good for large families?** It's great for families because it centralizes the mental load of inventory and chores. Anyone can ask the agent for updates, keeping everyone on the same page. **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.