How to Use the Mealie (Recipe Manager) MCP in OpenAI Agents SDK

Q: Does this MCP Server support auto-updating recipe details?

It does. An agent built with OpenAI Agents SDK can call getrecipe to inspect the current ingredients, make its edits, and then push the changes back using updaterecipe without manual coding.

Run your Mealie recipe database and meal plans directly from your OpenAI Agents SDK workflows with auto-discovered tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mealie (Recipe Manager) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Mealie (Recipe Manager) 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 Mealie (Recipe Manager) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Safe recipe curation with guardrails

OpenAI Agents SDK lets you build multi-agent systems with built-in guardrails. Since Mealie does not have a recycle bin, you do not want an autonomous agent running wild with the `delete_recipe` tool. You can configure a supervisor agent to intercept and confirm any destructive calls before they hit your live server. For safe daily tasks, your execution agents can freely use `list_recipes` or `get_recipe` to parse your collection. They can match ingredients and suggest dinner ideas without risking your years of curated family data.

Zero-config tool discovery for OpenAI Agents

This MCP Server exposes your entire recipe database to your agents instantly. By passing the streamable HTTP endpoint directly to your OpenAI Agents SDK constructor, the SDK auto-discovers tools like `create_recipe` and `update_recipe` with zero manual schema mapping. Your agents can immediately start parsing web pages to import new dishes. They read the raw HTML, extract the structure, and use `create_recipe` to populate your self-hosted instance in seconds.

Automate meal planning and shopping lists

You can set up a specialized agent to handle your weekly food prep. The agent uses `list_meal_plans` to see what is on the schedule, then compares it against your pantry list to find the gaps. Once the gaps are identified, the agent calls `create_shopping_list` and `toggle_shopping_list_item` to build your grocery list. All of this runs through the Vinkius MCP Server setup, meaning your Mealie credentials stay secure.

Setup guide

Set up Mealie (Recipe Manager) 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 Mealie (Recipe Manager) tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Mealie (Recipe Manager) 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="Mealie (Recipe Manager) Agent",
            instructions="You have access to Mealie (Recipe Manager) 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 Mealie. 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 Mealie (Recipe Manager) 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 Mealie (Recipe Manager) MCP in OpenAI Agents SDK

Install the SDK using pip, then initialize the streamable HTTP server parameters with your Vinkius endpoint. Pass this server object in the constructor when initializing your agents, and they will auto-discover the tools.

Yes, but you should use the SDK's guardrails. Because Mealie lacks an undo feature, we recommend wrapping `delete_recipe` and `delete_meal_plan` in a confirmation step to prevent accidental data loss.

It does. An agent built with OpenAI Agents SDK can call `get_recipe` to inspect the current ingredients, make its edits, and then push the changes back using `update_recipe` without manual coding.

Set the cache tools option to true in your agent configuration. This prevents the SDK from querying the Vinkius endpoint for the tool list on every single turn, making your recipe lookups significantly faster.

Vinkius runs this MCP Server in an ephemeral V8 Isolate sandbox. Your API tokens are never exposed to the LLM, and your private recipe data, meal plans, and shopping lists are only accessed during live tool execution.

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

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript