Grocy (Home ERP) MCP Server for WindsurfGive Windsurf instant access to 21 tools to Add Product Stock, Add Shopping List Item, Charge Battery, and more
GDPR Free for SubscribersWindsurf brings agentic AI coding to a purpose-built IDE. Connect Grocy (Home ERP) through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
Ask AI about this MCP Server for Windsurf
The Grocy (Home ERP) MCP Server for Windsurf is a standout in the Productivity category — giving your AI agent 21 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Gemini{
"mcpServers": {
"grocy-home-erp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Grocy (Home ERP) and 4,000+ MCP Servers from a single visual interface.
* 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
About 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.
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.
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.
The Grocy (Home ERP) MCP Server exposes 21 tools through the Vinkius. Connect it to Windsurf in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 21 Grocy (Home ERP) tools available for Windsurf
When Windsurf connects to Grocy (Home ERP) through Vinkius, your AI agent gets direct access to every tool listed below — spanning home-automation, pantry-tracker, shopping-list, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Add product stock on Grocy (Home ERP)
Add a specific amount of a product to stock
Add shopping list item on Grocy (Home ERP)
Add an item to the shopping list
Charge battery on Grocy (Home ERP)
Mark a battery as charged
Clear shopping list on Grocy (Home ERP)
Remove all items from the shopping list
Consume product stock on Grocy (Home ERP)
Consume a specific amount of a product from stock
Consume recipe on Grocy (Home ERP)
Consume all ingredients for a specific recipe from stock
Create task on Grocy (Home ERP)
Create a new task
Delete task on Grocy (Home ERP)
Delete a task
Execute chore on Grocy (Home ERP)
Mark a chore as executed
Get batteries on Grocy (Home ERP)
Get a list of all batteries
Get chores on Grocy (Home ERP)
Get a list of all chores
Get product on Grocy (Home ERP)
Get details for a specific product
Get recipe on Grocy (Home ERP)
Get details for a specific recipe
Get recipes on Grocy (Home ERP)
Get a list of all recipes
Get shopping list on Grocy (Home ERP)
Get all items on the shopping list
Get stock on Grocy (Home ERP)
Get all products currently in stock
Get tasks on Grocy (Home ERP)
Get a list of all tasks
Inventory product stock on Grocy (Home ERP)
Set the stock amount of a product to a specific value
Remove purchased shopping list on Grocy (Home ERP)
Remove all items marked as purchased from the shopping list
Transfer product stock on Grocy (Home ERP)
Transfer a product between locations
Update task on Grocy (Home ERP)
Update an existing task
Connect Grocy (Home ERP) to Windsurf via MCP
Follow these steps to wire Grocy (Home ERP) into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Open MCP Settings
Cmd+Shift+P and search "MCP"Add the server
mcp_config.jsonSave and reload
Start using Grocy (Home ERP)
Why Use Windsurf with the Grocy (Home ERP) MCP Server
Windsurf provides unique advantages when paired with Grocy (Home ERP) through the Model Context Protocol.
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) + Windsurf Use Cases
Practical scenarios where Windsurf combined with the Grocy (Home ERP) MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from Grocy (Home ERP) and generate models, types, or handlers based on real API responses
Live debugging: query Grocy (Home ERP) tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from Grocy (Home ERP) and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine Grocy (Home ERP) data with Cascade's code generation to scaffold entire features in minutes
Example Prompts for Grocy (Home ERP) in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with Grocy (Home ERP) immediately.
"What products do I currently have in stock?"
"Add 2 units of Coffee to my shopping list."
"Show me my pending chores and mark 'Vacuuming' as done."
Troubleshooting Grocy (Home ERP) MCP Server with Windsurf
Common issues when connecting Grocy (Home ERP) to Windsurf through Vinkius, and how to resolve them.
Server not connecting
Grocy (Home ERP) + Windsurf FAQ
Common questions about integrating Grocy (Home ERP) MCP Server with Windsurf.
How does Windsurf discover MCP tools?
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?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Explore More MCP Servers
View all →
USDA NASS
8 toolsAccess US agricultural statistics via USDA NASS — query crop yields, livestock data, farm economics and demographics from any AI agent.
MainWP
8 toolsManage multiple WordPress sites, updates, and security via the MainWP REST API.
NOAA Forecast — US Weather Predictions
5 toolsOfficial NWS weather forecasts for any US location: 7-day daily forecasts, 156-hour hourly forecasts, raw grid data, and meteorologist forecast discussions from 122 Weather Forecast Offices.
Insomnia (Collaborative API Design)
10 toolsManage API designs and collections via Insomnia — list organizations, projects, and files, and audit API specs.