Grocy (Home ERP) Connector for AI agents.

21 live capabilities

Manage your home inventory and chores with a conversational ERP

Live agent request Grocy (Home ERP) / Connector

Waiting for input…

AI Agent

Why people use Grocy (Home ERP)

Grocy Solves the Mental Load of Home Inventory

This Connector changes that by turning your Grocy instance into a proactive assistant. You can just ask your agent to check your stock or update a task, and it does the work for you. You get a central hub for your home life that actually responds to your questions.

What Vinkius changes

You get a voice or text interface for your entire home inventory and task list.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 6,100+ Connectors

Real-world use case 01

Checking for dinner ingredients

A user asks if they have chicken.
Real-world use case 02

Batch shopping

A user tells the agent they finished the groceries.
Real-world use case 03

Chore coordination

A partner asks what's left to do.

Complete set · 21capabilities

The complete Grocy (Home ERP) capability set.

These are the exact actions your AI can choose when you ask it to work with Grocy (Home ERP).

Capability set01 / 06

01—04

4 capabilities in this set.

Part of 21 available through Grocy (Home ERP).

01 Capability
Charge battery
Mark a household battery as fully charged. Use this to keep track of your home's power status.
02 Capability
Get batteries
See a list of all batteries and their current status. This helps you monitor home power.
03 Capability
Get chores
View all the chores currently assigned to your home. Use this to see what needs doing.
04 Capability
Get product
Look up specific details for an item in your inventory. Use this to check quantities or descriptions.

Capability set02 / 06

05—08

4 capabilities in this set.

Part of 21 available through Grocy (Home ERP).

05 Capability
Get recipe
View the full details of a specific recipe. This helps you see instructions quickly.
06 Capability
Get recipes
See your entire collection of saved recipes. Use this to browse your meal plans.
07 Capability
Get shopping list
View everything currently on your shopping list. Use this to see what you need to buy.
08 Capability
Get stock
See a full list of every product currently in stock. Use this for a complete pantry overview.

Capability set03 / 06

09—12

4 capabilities in this set.

Part of 21 available through Grocy (Home ERP).

09 Capability
Get tasks
See all tasks currently on your to-do list. Use this to check your current workload.
10 Capability
Inventory product stock
Set the stock amount of a product to a specific number. Use this to sync your inventory levels.
11 Capability
Transfer product stock
Move a product from one storage location to another. Use this to track items moving between rooms.
12 Capability
Add product stock
Add a specific amount of a product to your inventory. Use this to update stock levels after a delivery.

Capability set04 / 06

13—15

3 capabilities in this set.

Part of 21 available through Grocy (Home ERP).

13 Capability
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.
14 Capability
Clear shopping list
Wipe all items off your current shopping list. This is useful for starting a fresh shopping trip.
15 Capability
Consume product stock
Subtract a specific amount of a product from your stock. Use this for manual inventory updates.

Capability set05 / 06

16—18

3 capabilities in this set.

Part of 21 available through Grocy (Home ERP).

16 Capability
Consume recipe
Automatically subtract all ingredients for a recipe from your stock. This keeps your pantry accurate after cooking.
17 Capability
Create task
Add a new task to your household to-do list. Use this for one-off projects or reminders.
18 Capability
Delete task
Remove a specific task from your list. Use this to clean up your to-do list.

Capability set06 / 06

19—21

3 capabilities in this set.

Part of 21 available through Grocy (Home ERP).

19 Capability
Execute chore
Mark a household chore as completed. Use this to track recurring maintenance tasks.
20 Capability
Remove purchased shopping list
Clear out all items from your list that you've already bought. This helps keep your list clean.
21 Capability
Update task
Edit the details of an existing task. Use this to change dates or descriptions on your to-do list.

Set up in minutes

One URL. Then ask Grocy (Home ERP) to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Grocy (Home ERP) from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Grocy (Home ERP), and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Grocy (Home ERP) for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Grocy (Home ERP) URL.
Step 03

Save and start

Save the connection and enable Grocy (Home ERP) in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "grocy-home-erp": {
      "url": "https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Grocy (Home ERP)

Open Agent mode in chat and ask: "Using Grocy (Home ERP), help me...". 21 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "grocy-home-erp": {
      "url": "https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Grocy (Home ERP)

Ask Copilot: "Using Grocy (Home ERP), help me...". 21 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "grocy-home-erp": {
      "url": "https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Grocy (Home ERP)

Open Cascade and ask: "Using Grocy (Home ERP), help me...". 21 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "grocy-home-erp": {
      "url": "https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Grocy (Home ERP)

Ask Cline: "Using Grocy (Home ERP), help me...". 21 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add grocy-home-erp --transport http "https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Grocy (Home ERP)

Ask Claude: "Using Grocy (Home ERP), show me...". 21 tools are ready

Where the request belongs

Work Grocy can move forward.

Built around the request

This is for the person who feels overwhelmed by the mental load of running a home. It's for the person who wants to know what's in the pantry without walking to the kitchen or the person who needs a reliable way to coordinate chores with a partner.

01

Home Manager

Uses it to coordinate weekly meal plans and grocery runs without manual spreadsheets.

02

Self-Hoster

Connects their existing Grocy data to their AI capabilities to keep their home data private and accessible.

03

Busy Parent

Quickly checks if they have the right ingredients for dinner or marks off chores while on the go.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

Reclaim.ai

Equip your AI to directly manage tasks, habits, and scheduling links via your smart Reclaim.ai calendar assistant.

02 13 capabilities

Mealie (Recipe Manager)

Manage your Mealie recipes, meal plans, and shopping lists directly through your AI agent.

03 12 capabilities

Zapier Smart Home

Control smart home devices via natural language through Zapier NLA API. access 5000+ app integrations for home automation.

04 9 capabilities

Structured

Connect your AI to Structured. Programmatically manage your daily planner, tasks, and routines seamlessly directly from your terminal.

05 4 capabilities

Food Waste Reducer

Minimize food waste with intelligent meal planning and grocery optimization.

06 12 capabilities

Orderry

Manage your repair shop, orders, and inventory with Orderry and AI agents.

Bring your own AI

Change the model, client or framework. Keep Grocy connected.

Before you connect

Questions about Grocy.

The practical details behind the request, access and result.

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 capability 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 capability 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.

One connection away

Give your agent a direct line to Grocy.

Connect Grocy once. Keep it beside 6,100+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available