How to Use the Grocy (Home ERP) MCP in Pydantic AI

Q: Can I use Pydantic AI to clear my Grocy (Home ERP) list?

Yes, use the clearshoppinglist tool. The agent ensures the request is formatted correctly before sending it to the server.

Q: Does Pydantic AI support Grocy (Home ERP) task creation?

It does. Call createtask with the required parameters. The library validates your input types before the tool is invoked.

Strictly typed Grocy management for Pydantic AI. Ensure your household data is always valid and consistent.

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 Pydantic AI

Create your Vinkius account to connect Grocy (Home ERP) to Pydantic AI 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 Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe stock updates for Pydantic AI

Ensure your inventory data is always accurate. When your agent calls `add_product_stock`, Pydantic AI validates the structure against your schema. If the data is malformed, the agent crashes before the database updates. This prevents silent errors in your pantry records.

Validated shopping list management for Pydantic AI

Add items to your shopping list with full confidence. Every call to `add_shopping_list_item` is checked by your agent to ensure the product ID exists. This prevents ghost items from appearing on your list. Your agent maintains a clean state for your next trip to the store.

Chore execution with Pydantic AI

Track your cleaning schedule with strict validation. Your agent uses `get_chores` to list tasks and `execute_chore` to finalize them. Because Pydantic AI checks the return types, you know exactly what the chore status is. It eliminates guessing games about what is still pending.

Setup guide

Set up Grocy (Home ERP) MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "grocy-home-erp-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Grocy (Home ERP) tools.",
)

result = await agent.run("List recent Grocy (Home ERP) transactions")
print(result.output)

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 Pydantic AI

It checks every response against your defined Pydantic models. If the server returns unexpected data, the agent throws a validation error immediately.

Yes, use the `clear_shopping_list` tool. The agent ensures the request is formatted correctly before sending it to the server.

It does. Call `create_task` with the required parameters. The library validates your input types before the tool is invoked.

Store them in environment variables. The MCP server uses these to authenticate, keeping your secret keys out of your codebase.

The agent will catch the connection error. Since it is typed, you can define a fallback or retry logic to handle the network failure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.