Compatible with every major AI agent and IDE
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 Mastra AI?
Mastra's agent abstraction provides a clean separation between LLM logic and Grocy (Home ERP) tool infrastructure. Connect 21 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
- —
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Grocy (Home ERP) without touching business code
- —
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
- —
TypeScript-native: full type inference for every Grocy (Home ERP) tool response with IDE autocomplete and compile-time checks
- —
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Grocy (Home ERP) in Mastra AI
Grocy (Home ERP) and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Grocy (Home ERP) to Mastra AI 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 Mastra AI
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 Mastra AI 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 Mastra AI
Every tool call from Mastra AI 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 Mastra AI connect to MCP servers?
Create an MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.
Can Mastra agents use tools from multiple servers?
Yes. Pass multiple MCP clients to the agent constructor. Mastra merges all tool schemas and the agent can call any tool from any server.
Does Mastra support workflow orchestration?
Yes. Mastra has a built-in workflow engine that lets you chain MCP tool calls with branching logic, error handling, and parallel execution.
createMCPClient not exported
Install: npm install @mastra/mcp
Explore More MCP Servers
View all →
Gitpod
26 toolsAutomate cloud development environments — create, start, and manage Gitpod workspaces and organizations directly from any AI agent.
SafeCube Container Tracking
4 toolsTrack maritime containers — audit shipments and events via AI.

CHATFLY
8 toolsManage AI chatbots and knowledge bases via CHATFLY — train bots on custom data and track conversations directly from any AI agent.

UKG Pro Workforce Management
4 toolsManage schedules, timesheets, accruals, and time-off requests via UKG Pro WFM.
