Skip to content
Vinkius

TheMealDB Connector for AI agents.

10 live capabilities

Find global recipes and meal plans with a massive culinary database.

Live agent request TheMealDB / Connector

Waiting for input…

AI Agent

Why people use TheMealDB

TheMealDB Recipe Search for Global Meal Planning

This Connector changes that by letting your AI client do the heavy lifting. You just tell your agent what you're in the mood for or what ingredients you have on hand, and it pulls the full recipes from a massive global database. You get the ingredients and the instructions immediately, letting you spend less time searching and more time actually cooking.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

You get instant access to a global recipe database without the manual searching.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Cooking with leftovers

    You have chicken and peppers.

  2. Real-world use case 02

    Planning a themed dinner

    You want to host an Italian night.

  3. Real-world use case 03

    Finding a random dessert

    You're craving something sweet but don't know what.

Complete set · 10capabilities

The complete TheMealDB capability set.

These are the exact actions your AI can choose when you ask it to work with TheMealDB.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 10 available through TheMealDB.

  1. 01 Capability

    Filter by ingredient

    Find meals that feature a specific main ingredient. This helps when you're trying to use up what's left in your pantry.

  2. 02 Capability

    Get random meal

    Get a completely random meal suggestion. Use this when you have zero ideas and just want to cook something new.

  3. 03 Capability

    Filter by area

    Filter recipes by a specific geographic region. Find authentic dishes from Italy, Mexico, or India instantly.

  4. 04 Capability

    Filter by category

    Filter meals by a specific food type. Quickly find all the seafood or vegetarian options in the database.

Capability set02 / 03

05—07

3 capabilities in this set.

Part of 10 available through TheMealDB.

  1. 05 Capability

    List ingredients

    Browse every ingredient available in the database. Use this to see the full scope of what you can cook.

  2. 06 Capability

    List areas

    See a full list of all available cuisine areas. This is great for exploring different global flavors.

  3. 07 Capability

    List categories

    Get a list of all meal categories like Beef, Chicken, or Dessert. Use this to narrow down your search.

Capability set03 / 03

08—10

3 capabilities in this set.

Part of 10 available through TheMealDB.

  1. 08 Capability

    Lookup meal

    Get the complete details for a specific meal using its ID. This retrieves the full recipe and instructions.

  2. 09 Capability

    Search by letter

    Find meals starting with a specific letter. This is a quick way to browse the database alphabetically.

  3. 10 Capability

    Search meals

    Search for meals by name and get up to 100 results. Use this for broad searches when you have a general idea of what you want.

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 preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_tCC4deQfCpXtEFPQwzeuEnQIGh8ZgwzPFDOG8bNo/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it TheMealDB, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable TheMealDB for the conversation.

Where the request belongs

Work TheMealDB can move forward.

Built around the request

TheMealDB is for the home cook who's tired of staring at an empty fridge, the meal planner organizing a weekly menu, or the food blogger researching global cuisines.

01

Home Cook

Uses the Connector on Tuesday nights to find a quick dinner based on the leftover chicken in the fridge.

02

Meal Planner

Uses the Connector to build a diverse 7-day meal plan featuring different cuisines like Thai, Greek, and Mexican.

03

Food Blogger

Uses the Connector to quickly research and list ingredients for various international dishes to create content.

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 recipes based on what I have in my fridge?

Yes, it can. You can ask your agent to find meals based on a specific main ingredient, like 'what can I make with salmon?'

Does TheMealDB MCP have recipes from different countries?

Yes, it covers a wide range of global cuisines, including Italian, Indian, Mexican, and many more.

Can I get a random meal idea with TheMealDB MCP?

Absolutely. You can ask for a random meal suggestion whenever you're feeling stuck on what to cook for dinner.

Is it hard to set up TheMealDB MCP?

No, it's very easy. Once you subscribe on Vinkius and connect it to your AI client, you can start searching immediately.

Can I use TheMealDB MCP to find specific meal types like desserts?

Yes, you can browse by category to find specific types of meals, including desserts, seafood, and more.

What happens when I ask for a recipe with TheMealDB MCP?

Your agent will pull the full details for that meal, including a complete list of ingredients and step-by-step cooking instructions.

Do I need an API key to use TheMealDB?

No! TheMealDB is completely free and open. No API key is required to search and retrieve recipes.

Can I get full recipe details with ingredients and instructions?

Yes! Use the lookup_meal capability with a meal ID to retrieve the full recipe including all ingredients with measurements, category, area, and detailed instructions.

How do I find recipes by ingredient?

Use the filter_by_ingredient capability with the ingredient name. It returns all meals that have that ingredient as their main component.

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