An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect Grocy Home ERP to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Run your entire household through a simple chat interface.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 21 capabilities

We ship only the actions that matter.

Capability set01 / 06

01-04

4 capabilities in this set.

Part of 21 available through Grocy.

  1. 01

    Add product stock

    Adds a specific amount of a product to your current inventory.

  2. 02

    Clear shopping list

    Wipes every item from your current shopping list.

  3. 03

    Consume product stock

    Reduces the stock level of a product by a specific amount.

  4. 04

    Create task

    Generates a new task in your Grocy system.

Capability set02 / 06

05-08

4 capabilities in this set.

Part of 21 available through Grocy.

  1. 05

    Delete task

    Removes a specific task from your list.

  2. 06

    Get chores

    Retrieves a full list of all your current chores.

  3. 07

    Get product

    Fetches detailed information for a single product.

  4. 08

    Get recipes

    Pull a list of all recipes you have saved.

Capability set03 / 06

09-12

4 capabilities in this set.

Part of 21 available through Grocy.

  1. 09

    Remove purchased shopping list

    Clears only the items you have already marked as purchased from your shopping list.

  2. 10

    Transfer product stock

    Moves a product from one storage location to another.

  3. 11

    Update task

    Modifies the details of an existing task.

  4. 12

    Charge battery

    Marks a specific battery as fully charged.

Capability set04 / 06

13-15

3 capabilities in this set.

Part of 21 available through Grocy.

  1. 13

    Get batteries

    Lists all the batteries tracked in your system.

  2. 14

    Get recipe

    Retrieves the full details and ingredients for a specific recipe.

  3. 15

    Get shopping list

    Shows you everything currently on your shopping list.

Capability set05 / 06

16-18

3 capabilities in this set.

Part of 21 available through Grocy.

  1. 16

    Get stock

    Returns a list of all products currently in your inventory.

  2. 17

    Get tasks

    Fetches a list of all tasks you have created.

  3. 18

    Inventory product stock

    Sets the stock level of a product to a specific, exact value.

Capability set06 / 06

19-21

3 capabilities in this set.

Part of 21 available through Grocy.

  1. 19

    Add shopping list item

    Adds a new item to your Grocy shopping list.

  2. 20

    Consume recipe

    Automatically subtracts all necessary ingredients from your stock when you cook a recipe.

  3. 21

    Execute chore

    Marks a specific chore as completed.

Real work

What teams actually run

01

Quick Pantry Checks

Ask your agent if you have enough ingredients for a specific meal before you start cooking.

02

Hands-Free Shopping Lists

Tell your agent to add items to your list while you are walking through the kitchen.

03

Chore Coordination

Check your pending chores and mark them as finished using your AI client.

04

Inventory Audits

Use the agent to set exact stock levels after doing a manual pantry walkthrough.

Automate a task

Put Grocy to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Grocy works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put Grocy to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1013ms average. Fast in production.

Grocy is checked daily against the live service.

Daily averagePeak 1237ms
Oct 3Today
Fastest day
757ms
Slowest day
1237ms
14-day trend
Improving-16%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 21 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Grocy, so you can see the experience inside your AI.

It does not authenticate your account with Grocy. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Grocy Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Grocy capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "grocy-home-erp-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_0YT3fQyOGu1lnzU1esru7YB7a2aps41Fsn4992Ml/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Grocy in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Grocy owners hand off.

This is built for people who already use Grocy to run their homes and want a better way to interact with their data.

  • 01

    Self-Hosters

    People running Grocy on local hardware who want to use AI clients like Cursor or Claude to manage their data.

  • 02

    Home Organizers

    Users who need to check pantry levels or grocery needs without opening a specific app.

  • 03

    Busy Families

    People who want to coordinate chores and shopping lists through simple text commands.

FAQ

Questions Grocy owners ask.

  • 01

    Do I need to host Grocy myself?

    Yes, this MCP connects to your existing self-hosted Grocy instance. You provide the URL and API key so the agent can talk to your data.

  • 02

    Which AI clients can I use?

    You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.

  • 03

    Can the AI actually change my stock levels?

    Yes, the agent can add, consume, or set exact stock amounts using the capabilities provided in this MCP.

  • 04

    Is my Grocy data secure?

    Vinkius manages the connection to your instance using your provided credentials, allowing your agent to perform actions on your behalf.

  • 05

    Can I manage chores through this?

    Yes, you can list pending chores, create new ones, or mark them as executed through your AI client.

  • 06

    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.

  • 07

    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.

  • 08

    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.

Explore

More in Productivity

Suggestions

Connect Grocy to Claude, Cursor, ChatGPT & more