Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Grocy with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Automate your household management with Grocy. track inventory, manage shopping lists, and organize chores directly from your AI agent.

Included with plan

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

Complete set · 21 capabilities

The complete Grocy capability set.

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

Capability set01 / 06

01-04

4 capabilities in this set.

Part of 21 available through Grocy.

  1. 01

    Add product stock

    Add a specific amount of a product to stock

  2. 02

    Clear shopping list

    Remove all items from the shopping list

  3. 03

    Consume product stock

    Consume a specific amount of a product from stock

  4. 04

    Create task

    Create a new task

Capability set02 / 06

05-08

4 capabilities in this set.

Part of 21 available through Grocy.

  1. 05

    Delete task

    Delete a task

  2. 06

    Get chores

    Get a list of all chores

  3. 07

    Get product

    Get details for a specific product

  4. 08

    Get recipes

    Get a list of all recipes

Capability set03 / 06

09-12

4 capabilities in this set.

Part of 21 available through Grocy.

  1. 09

    Remove purchased shopping list

    Remove all items marked as purchased from the shopping list

  2. 10

    Transfer product stock

    Transfer a product between locations

  3. 11

    Update task

    Update an existing task

  4. 12

    Charge battery

    Mark a battery as charged

Capability set04 / 06

13-15

3 capabilities in this set.

Part of 21 available through Grocy.

  1. 13

    Get batteries

    Get a list of all batteries

  2. 14

    Get recipe

    Get details for a specific recipe

  3. 15

    Get shopping list

    Get all items on the shopping list

Capability set05 / 06

16-18

3 capabilities in this set.

Part of 21 available through Grocy.

  1. 16

    Get stock

    Get all products currently in stock

  2. 17

    Get tasks

    Get a list of all tasks

  3. 18

    Inventory product stock

    Set the stock amount of a product to a specific value

Capability set06 / 06

19-21

3 capabilities in this set.

Part of 21 available through Grocy.

  1. 19

    Add shopping list item

    Add an item to the shopping list

  2. 20

    Consume recipe

    Consume all ingredients for a specific recipe from stock

  3. 21

    Execute chore

    Mark a chore as executed

Observed, not estimated

914ms average. Fast in production.

Grocy is checked daily against the live service.

Daily averagePeak 1060ms
Aug 20Today
Fastest day
783ms
Slowest day
1060ms
14-day trend
Slowing+11%

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

FAQ

Questions Grocy owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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