How to Use the Grocy (Home ERP) MCP in Windsurf

Q: How do I connect the Grocy (Home ERP) MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, open Settings, go to Cascade, find the MCP Servers UI, and paste the connection details. Click Refresh in the MCP panel to let Cascade auto-discover the 21 tools.

Q: How does the Grocy (Home ERP) integration in Windsurf handle chores?

Cascade uses the getchores tool to pull your list of household tasks. When you complete a chore, tell Cascade to run executechore to log the completion. It handles the database updates behind the scenes.

Q: What happens when I consume ingredients for a meal?

You tell Cascade what you cooked, and it runs consumerecipe to update your pantry levels. If you did not cook a full recipe, it uses consumeproductstock for individual items instead. This keeps your inventory accurate with a single command.

Run your household inventory on autopilot by letting Windsurf chain your pantry, shopping, and chore updates.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Grocy (Home ERP) MCP to Windsurf

Create your Vinkius account to connect Grocy (Home ERP) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Grocy (Home ERP) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autopilot Pantry Audits with Windsurf

The Grocy (Home ERP) MCP Server exposes your physical household state directly to Cascade. When you tell Cascade to update your inventory, it runs `get_stock` to see what is currently on hand, compares it to your target levels, and executes `inventory_product_stock` to fix discrepancies. You do not have to trigger these steps one by one. Cascade handles the entire sequence in a single run. If stock runs low, it instantly calls `add_shopping_list_item` to queue up replacements. This turns manual inventory tracking into a background process that actually stays accurate.

Automated Recipe Meal Prep

The Grocy (Home ERP) MCP Server coordinates meal planning directly with your actual kitchen inventory. Cascade calls `get_recipes` to check your saved meals, then cross-references ingredients with `get_stock` to see what you actually have in the cupboard. Once you pick a meal, Cascade runs `consume_recipe` to deduct all necessary ingredients from your records in one go. If you are missing a few items, it appends them to your active list using `add_shopping_list_item` without waiting for your permission.

Dynamic Chore and Task Chains

The Grocy (Home ERP) MCP Server manages household maintenance schedules so you don't lose track of chores. Cascade uses `get_chores` to pull your household schedule, identifies overdue items, and assigns them based on your current availability. Marking a task done is equally fast. It runs `execute_chore` to update the schedule, then cleans up your active board by running `update_task` or `delete_task` to keep your dashboard clean.

Setup guide

Set up Grocy (Home ERP) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Grocy (Home ERP) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Grocy (Home ERP) payment history." If connected, Cascade will call the Grocy (Home ERP) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

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

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Grocy (Home ERP) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Grocy (Home ERP) MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` key. Alternatively, open Settings, go to Cascade, find the MCP Servers UI, and paste the connection details. Click Refresh in the MCP panel to let Cascade auto-discover the 21 tools.

Yes, Cascade handles this by chaining multiple tools together. It runs `get_shopping_list` to see what is missing, compares it to your pantry stock, and adds items using `add_shopping_list_item`. When you get home, it runs `remove_purchased_shopping_list` to clean up.

Cascade uses the `get_chores` tool to pull your list of household tasks. When you complete a chore, tell Cascade to run `execute_chore` to log the completion. It handles the database updates behind the scenes.

You tell Cascade what you cooked, and it runs `consume_recipe` to update your pantry levels. If you did not cook a full recipe, it uses `consume_product_stock` for individual items instead. This keeps your inventory accurate with a single command.

Your pantry stock, chore logs, and task details remain on your own self-hosted Grocy instance. Windsurf connects directly to your private server via secure, ephemeral connections managed by Vinkius. No household inventory data is stored or processed on external third-party servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript