Bring Home Automation
to Windsurf
Learn how to connect Grocy (Home ERP) to Windsurf and start using 21 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the Grocy (Home ERP) MCP Server?
Connect your Grocy instance to any AI agent and take full control of your home ERP through natural conversation. Grocy is the self-hosted solution for managing your household.
What you can do
- Stock Management — List all products in stock, add new items, consume supplies, and perform inventory checks to keep your pantry updated.
- Shopping Lists — Manage your grocery needs by adding items to your list, clearing purchased items, or viewing what's missing.
- Recipes & Meal Planning — Browse your recipe collection and automatically consume ingredients from your stock when you cook.
- Chore Tracking — Keep track of household maintenance by listing pending chores and marking them as executed.
- Battery & Task Management — Monitor battery charge cycles and manage general household tasks and reminders.
How it works
- Subscribe to this server
- Enter your Grocy API Key and Base URL
- Start managing your home from Claude, Cursor, or any MCP-compatible client
No more manual entry on a small screen. Your AI acts as your personal home manager, helping you stay organized and efficient.
Who is this for?
- Home Organizers — instantly check if you have enough ingredients for dinner without opening the pantry.
- Busy Families — coordinate chores and shopping lists through simple voice or text commands.
- Self-Hosters — leverage your existing Grocy data within your favorite AI tools and IDEs.
Built-in capabilities (21)
Add a specific amount of a product to stock
Add an item to the shopping list
Mark a battery as charged
Remove all items from the shopping list
Consume a specific amount of a product from stock
Consume all ingredients for a specific recipe from stock
Create a new task
Delete a task
Mark a chore as executed
Get a list of all batteries
Get a list of all chores
Get details for a specific product
Get details for a specific recipe
Get a list of all recipes
Get all items on the shopping list
Get all products currently in stock
Get a list of all tasks
Set the stock amount of a product to a specific value
Remove all items marked as purchased from the shopping list
Transfer a product between locations
Update an existing task
Why Windsurf?
Windsurf's Cascade agent chains multiple Grocy (Home ERP) tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 21 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
- —
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
- —
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
- —
JSON-based configuration means zero code changes: paste a URL, reload, and all 21 tools are immediately available
- —
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Grocy (Home ERP) in Windsurf
Grocy (Home ERP) and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Grocy (Home ERP) to Windsurf through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Grocy (Home ERP) in Windsurf
The Grocy (Home ERP) MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 21 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Windsurf only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
Grocy (Home ERP) for Windsurf
Every tool call from Windsurf to the Grocy (Home ERP) MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
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.
How does Windsurf discover MCP tools?
Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.
Can Cascade chain multiple MCP tool calls?
Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
Does Windsurf support multiple MCP servers?
Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.
Server not connecting
Check Settings → MCP for the server status. Try toggling it off and on.
Explore More MCP Servers
View all →
IPQualityScore (IPQS)
10 toolsDetect fraud, proxies, and malicious activity via IPQS API.
U.S. Census Population — Demographics, Age & Diversity
5 toolsAccess demographic data from the American Community Survey (ACS). Get total population, median age, and detailed racial/ethnic breakdowns (White, Black, Asian, Hispanic, Foreign-born) for any U.S. state, county, or city.
PitchBook
13 toolsAI private market intelligence: research companies, deals, investors, and funds via agents.
LangSmith
3 toolsObservability and evaluation platform for LLM applications — monitor traces, debug agent runs, and track performance metrics across your AI stack.