4,000+ servers built on vurb.ts
Vinkius
OpenAI Agents SDKSDK
OpenAI Agents SDK
Grocy (Home ERP) MCP Server

Bring Home Automation
to OpenAI Agents SDK

Learn how to connect Grocy (Home ERP) to OpenAI Agents SDK and start using 21 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.

MCP Inspector GDPR Free for Subscribers
Add Product StockAdd Shopping List ItemCharge BatteryClear Shopping ListConsume Product StockConsume RecipeCreate TaskDelete TaskExecute ChoreGet BatteriesGet ChoresGet ProductGet RecipeGet RecipesGet Shopping ListGet StockGet TasksInventory Product StockRemove Purchased Shopping ListTransfer Product StockUpdate Task

Compatible with every major AI agent and IDE

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
Grocy (Home ERP)

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

  1. Subscribe to this server
  2. Enter your Grocy API Key and Base URL
  3. 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_product_stock

Add a specific amount of a product to stock

add_shopping_list_item

Add an item to the shopping list

charge_battery

Mark a battery as charged

clear_shopping_list

Remove all items from the shopping list

consume_product_stock

Consume a specific amount of a product from stock

consume_recipe

Consume all ingredients for a specific recipe from stock

create_task

Create a new task

delete_task

Delete a task

execute_chore

Mark a chore as executed

get_batteries

Get a list of all batteries

get_chores

Get a list of all chores

get_product

Get details for a specific product

get_recipe

Get details for a specific recipe

get_recipes

Get a list of all recipes

get_shopping_list

Get all items on the shopping list

get_stock

Get all products currently in stock

get_tasks

Get a list of all tasks

inventory_product_stock

Set the stock amount of a product to a specific value

remove_purchased_shopping_list

Remove all items marked as purchased from the shopping list

transfer_product_stock

Transfer a product between locations

update_task

Update an existing task

Why OpenAI Agents SDK?

The OpenAI Agents SDK auto-discovers all 21 tools from Grocy (Home ERP) through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Grocy (Home ERP), another analyzes results, and a third generates reports, all orchestrated through Vinkius.

  • Native MCP integration via MCPServerSse, pass the URL and the SDK auto-discovers all tools with full type safety

  • Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

  • Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

  • First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

O
See it in action

Grocy (Home ERP) in OpenAI Agents SDK

AI AgentVinkius
High Security·Kill Switch·Plug and Play
Why Vinkius

Grocy (Home ERP) and 4,000+ other MCP servers. One platform. One governance layer.

Teams that connect Grocy (Home ERP) to OpenAI Agents SDK 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.

4,000+MCP Servers ready
<40msCold start
60%Token savings
Raw MCP
Vinkius
Server catalogFind and host yourself4,000+ managed
InfrastructureSelf-hostedSandboxed V8 isolates
Credential handlingPlaintext in configVault + runtime injection
Data loss preventionNoneConfigurable DLP policies
Kill switchNoneGlobal instant shutdown
Financial circuit breakersNonePer-server limits + alerts
Audit trailNoneEd25519 signed logs
SIEM log streamingNoneSplunk, Datadog, Webhook
HoneytokensNoneCanary alerts on leak
Custom domainsNot applicableDNS challenge verified
GDPR complianceManual effortAutomated purge + export
Enterprise Security

Why teams choose Vinkius for Grocy (Home ERP) in OpenAI Agents SDK

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 OpenAI Agents SDK 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.

Grocy (Home ERP)
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* 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

The Vinkius Advantage

How Vinkius secures Grocy (Home ERP) for OpenAI Agents SDK

Every tool call from OpenAI Agents SDK to the Grocy (Home ERP) MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.

< 40msCold start
Ed25519Signed audit chain
60%Token savings
FAQ

Frequently asked questions

01

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.

02

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.

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.

04

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.

05

Can I use multiple MCP servers in one agent?

Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.

06

Does the SDK support streaming responses?

Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.

07

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

08

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Explore More MCP Servers

View all →