TheMealDB Connector for AI agents.
5 live capabilities
Get international recipes and cooking instructions for your meal planning.
Waiting for input…
Why people use TheMealDB
TheMealDB for International Recipe Discovery
This Connector changes that by putting the entire database into your chat. Just tell your agent what you are craving, and it pulls the full recipe, exact measurements, and even a video tutorial into one message. You go from searching to cooking in seconds.
What Vinkius changes
You get instant access to a massive global recipe database without leaving your chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
The What's for Dinner Problem
A user asks for a random meal and gets a surprise recipe with instructions and a video link.
- Real-world use case 02
The Weekly Meal Plan
A user asks for five different Italian recipes, and the agent pulls a list of pasta and meat dishes.
- Real-world use case 03
The Dietary Filter
A user needs a vegan breakfast and the agent finds several options using the category filter.
Complete set · 5capabilities
The complete TheMealDB capability set.
These are the exact actions your AI can choose when you ask it to work with TheMealDB.
01—03
3 capabilities in this set.
Part of 5 available through TheMealDB.
- 01 Capability
Get meals by category
This capability finds recipes grouped by type, such as Beef, Pasta, or Vegan. This helps when you know the vibe but not the specific dish.
- 02 Capability
Get meal details
This capability fetches the complete data for a specific recipe using its unique ID. Use this when you need to drill down into a specific dish.
- 03 Capability
Get meals by cuisine
This capability browses meals by specific countries like Italian, Japanese, or Mexican. It is great for exploring different cultural flavors.
04—05
2 capabilities in this set.
Part of 5 available through TheMealDB.
- 04 Capability
Get random meal
This capability gets a surprise recipe when you are looking for inspiration. It is the perfect what is for dinner button.
- 05 Capability
Search meals
This capability searches for specific dish names to get full details, including ingredients and YouTube links. It provides everything you need to start cooking.
Set up in minutes
One URL. Then ask TheMealDB to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use TheMealDB from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_XatQFlCvsJKi0rAMn46oESfjKOkg0fOCAN4kwgn6/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it TheMealDB, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable TheMealDB for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_XatQFlCvsJKi0rAMn46oESfjKOkg0fOCAN4kwgn6/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the TheMealDB URL.
- Step 03
Save and start
Save the connection and enable TheMealDB in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"themealdb": {
"url": "https://edge.vinkius.com/vk_preview_XatQFlCvsJKi0rAMn46oESfjKOkg0fOCAN4kwgn6/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using TheMealDB
Open Agent mode in chat and ask: "Using TheMealDB, help me...". 5 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"themealdb": {
"url": "https://edge.vinkius.com/vk_preview_XatQFlCvsJKi0rAMn46oESfjKOkg0fOCAN4kwgn6/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using TheMealDB
Ask Copilot: "Using TheMealDB, help me...". 5 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"themealdb": {
"url": "https://edge.vinkius.com/vk_preview_XatQFlCvsJKi0rAMn46oESfjKOkg0fOCAN4kwgn6/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using TheMealDB
Open Cascade and ask: "Using TheMealDB, help me...". 5 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"themealdb": {
"url": "https://edge.vinkius.com/vk_preview_XatQFlCvsJKi0rAMn46oESfjKOkg0fOCAN4kwgn6/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using TheMealDB
Ask Cline: "Using TheMealDB, help me...". 5 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add themealdb --transport http "https://edge.vinkius.com/vk_preview_XatQFlCvsJKi0rAMn46oESfjKOkg0fOCAN4kwgn6/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using TheMealDB
Ask Claude: "Using TheMealDB, show me...". 5 tools are ready
Where the request belongs
Work TheMealDB can move forward.
For home cooks who want to expand their culinary horizons without the research fatigue, food bloggers who need reliable recipe data, and developers building meal-planning capabilities.
The Busy Parent
Planning weeknight dinners that satisfy everyone without spending an hour on recipe sites.
The Food Blogger
Gathering diverse, international recipes to build out a new content series.
The Meal Prep Enthusiast
Organizing a weekly menu based on specific categories like Vegan or Seafood.
The App Developer
Building a cooking app and needing a reliable source for meal data and instructions.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsTheMealDB
Search recipes, browse ingredients, and discover meals from global cuisines via AI.
Spoonacular
Search recipes, analyze nutrition, and plan meals with AI-powered food data.
BigOven
Access over a million recipes via BigOven. search dishes, read reviews, and explore collections directly from any AI agent.
Edamam
Search over 2.3 million recipes, analyze nutritional data, and access a database of 900,000+ food items directly from your AI agent.
Bring your own AI
Change the model, client or framework. Keep TheMealDB connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about TheMealDB.
The practical details behind the request, access and result.
Can TheMealDB MCP help me find specific diets?
Yes, it lets your agent filter by categories like Vegan, Vegetarian, and others. You can quickly find meals that fit your lifestyle without searching through irrelevant recipes.
Does TheMealDB MCP include cooking instructions?
Yes, it provides full step-by-step directions and exact measurements. You won't just get a list of ingredients; you'll get the actual plan for making the dish.
Can I use TheMealDB MCP to find international food?
Definitely. It covers over 27 national cuisines, from Japanese to Mexican. It's a great way to explore different cultures from your kitchen.
Will TheMealDB MCP show me how to cook the food?
Most recipes include a link to a YouTube tutorial. This is perfect if you're a visual learner and want to see the techniques before you start.
Is TheMealDB MCP good for meal planning?
It's a great capability for that. You can ask your agent to build a weekly menu based on specific categories or cuisines to keep your meals varied and interesting.
Can I search for specific dishes with TheMealDB MCP?
Yes, you can search by name. If you're looking for something specific like Pad Thai or Sushi, the agent can pull up the full details for you.
Do I need an API key?
No. TheMealDB provides free open access for development and personal projects. No registration or API key required.
One connection away
Give your agent a direct line to TheMealDB.
Connect TheMealDB once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available