Mealie (Recipe Manager) MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 13 tools to Create Meal Plan, Create Recipe, Create Shopping List, and more
GDPR Free for SubscribersThe OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Mealie (Recipe Manager) through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The Mealie (Recipe Manager) MCP Server for OpenAI Agents SDK is a standout in the Productivity category — giving your AI agent 13 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="Mealie (Recipe Manager) Assistant",
instructions=(
"You help users interact with Mealie (Recipe Manager). "
"You have access to 13 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from Mealie (Recipe Manager)"
)
print(result.final_output)
asyncio.run(main())
* 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
About Mealie (Recipe Manager) MCP Server
Connect your Mealie instance to any AI agent and take full control of your kitchen workflow. From organizing recipes to automating your weekly meal planning, your AI acts as a digital sous-chef.
The OpenAI Agents SDK auto-discovers all 13 tools from Mealie (Recipe Manager) through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Mealie (Recipe Manager), another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Recipe Management — List, create, and update recipes. Fetch full details using slugs to get ingredients and instructions instantly.
- Meal Planning — View your current meal plans and schedule new recipes for specific dates to stay organized.
- Shopping Lists — Manage your grocery runs by listing shopping lists and toggling items as you find them in the store.
- Organization — Browse through your custom categories and tags to find the perfect meal for any occasion.
The Mealie (Recipe Manager) MCP Server exposes 13 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 13 Mealie (Recipe Manager) tools available for OpenAI Agents SDK
When OpenAI Agents SDK connects to Mealie (Recipe Manager) through Vinkius, your AI agent gets direct access to every tool listed below — spanning recipe-management, meal-planning, shopping-list, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Create meal plan on Mealie (Recipe Manager)
Create a new meal plan entry
Create recipe on Mealie (Recipe Manager)
Create a new recipe
Create shopping list on Mealie (Recipe Manager)
Create a new shopping list
Delete meal plan on Mealie (Recipe Manager)
Delete a meal plan entry
Delete recipe on Mealie (Recipe Manager)
Remove a recipe
Get recipe on Mealie (Recipe Manager)
Retrieve a specific recipe by its slug
List categories on Mealie (Recipe Manager)
List all categories
List meal plans on Mealie (Recipe Manager)
Retrieve current meal plans
List recipes on Mealie (Recipe Manager)
List all recipes
List shopping lists on Mealie (Recipe Manager)
List all shopping lists
List tags on Mealie (Recipe Manager)
List all tags
Toggle shopping list item on Mealie (Recipe Manager)
Toggle shopping list item completion
Update recipe on Mealie (Recipe Manager)
Update an existing recipe
Connect Mealie (Recipe Manager) to OpenAI Agents SDK via MCP
Follow these steps to wire Mealie (Recipe Manager) into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the Mealie (Recipe Manager) MCP Server
OpenAI Agents SDK provides unique advantages when paired with Mealie (Recipe Manager) through the Model Context Protocol.
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
Mealie (Recipe Manager) + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the Mealie (Recipe Manager) MCP Server delivers measurable value.
Automated workflows: build agents that query Mealie (Recipe Manager), process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries Mealie (Recipe Manager), another analyzes results, a third generates reports
Data enrichment pipelines: stream data through Mealie (Recipe Manager) tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query Mealie (Recipe Manager) to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for Mealie (Recipe Manager) in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Mealie (Recipe Manager) immediately.
"List all my recipes in Mealie."
"Get the full recipe for the slug 'classic-lasagna'."
"Mark item ID 'milk-123' as checked in shopping list 'grocery-list-456'."
Troubleshooting Mealie (Recipe Manager) MCP Server with OpenAI Agents SDK
Common issues when connecting Mealie (Recipe Manager) to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
Mealie (Recipe Manager) + OpenAI Agents SDK FAQ
Common questions about integrating Mealie (Recipe Manager) MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
SolarAnywhere API
4 toolsMonitor solar data — audit irradiance and sites via AI.
Oura
7 toolsAccess your Oura Ring health data — sleep, activity, readiness, HRV, heart rate and workout metrics from any AI agent.
Getpaid
12 toolsManage billing, track payments, and initiate checkouts via AI agents with Getpaid.io.
Open-Meteo Full Access
15 toolsThe ultimate weather Mega-Server: 15 tools covering forecast, historical (84 years), marine, air quality, pollen, climate projections (to 2100), flood, geocoding, and elevation — all in one zero-auth integration.