How to Use the Grocy (Home ERP) MCP in OpenAI Agents SDK

Q: Can the OpenAI Agents SDK track inventory in Grocy (Home ERP) automatically?

Yes, by calling getstock and consumeproductstock. You can hook these into your agent logic to log items as they are used.

Q: How do I handle task updates in Grocy (Home ERP) with OpenAI Agents SDK?

Use the updatetask tool. Your agent can pull the current status and push changes directly back to your database.

Manage your home with the OpenAI Agents SDK and Grocy. Automate inventory and chores with production-ready agent workflows.

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

Create your Vinkius account to connect Grocy (Home ERP) to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Inventory control for OpenAI Agents SDK

Track your pantry in real-time. Your agent uses `get_stock` to see what is on hand and `consume_product_stock` to log usage as it happens. This keeps your data accurate without manual entry. Your agent knows exactly when to trigger a restock based on the current levels.

Automated shopping lists for OpenAI Agents SDK

Keep your grocery list updated effortlessly. Your agent checks your current inventory and adds missing items using `add_shopping_list_item`. Once you finish shopping, clear the list with `remove_purchased_shopping_list`. It keeps the loop tight and removes the friction of maintaining a paper list.

Chore management for OpenAI Agents SDK

Assign and track household maintenance tasks through your agent. You can pull the full list with `get_chores` to see what needs attention. When a task is done, the agent calls `execute_chore` to update the status. This ensures everyone knows what is finished and what remains.

Setup guide

Set up Grocy (Home ERP) MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Grocy (Home ERP) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Grocy (Home ERP) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Grocy (Home ERP) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Grocy (Home ERP) Agent",
            instructions="You have access to Grocy (Home ERP) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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

You instantiate an MCPServerStreamableHttp object with your endpoint. Pass this to your Agent constructor to let your agent discover all 21 tools automatically.

Yes, by calling `get_stock` and `consume_product_stock`. You can hook these into your agent logic to log items as they are used.

Absolutely. Since the SDK validates actions before execution, your agent will check the logic of any `inventory_product_stock` call before it hits your server.

Your data stays on your local Grocy server. The agent only interacts with the specific endpoints you authorize via the MCP protocol.

Use the `update_task` tool. Your agent can pull the current status and push changes directly back to your database.

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