Skip to content
Vinkius

TheMealDB Connector for AI agents.

13 live capabilities

Find global recipes and cooking instructions instantly.

Live agent request TheMealDB / Connector

Waiting for input…

AI Agent

Why people use TheMealDB

TheMealDB for Faster Recipe Discovery

This Connector changes that by letting your AI agent do the digging for you. Just tell it what you want, and it pulls the specific measurements, instructions, and categories instantly.

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

What Vinkius changes

That you get instant access to a global recipe database directly inside your AI chat.

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

One account · 6,100+ Connectors

  1. Real-world use case 01

    Dinner planning with leftovers

    A user asks for a Mexican dish with chicken, and the agent finds several options using filter_by_ingredient.

  2. Real-world use case 02

    Recipe research for blogs

    A blogger needs a list of vegan starters and gets a structured list of categories to organize their content.

  3. Real-world use case 03

    Populating a food app

    A developer wants to populate a random meal button and uses get_random_meal to fetch data for the UI.

Complete set · 13capabilities

The complete TheMealDB capability set.

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

Capability set01 / 04

01—04

4 capabilities in this set.

Part of 13 available through TheMealDB.

  1. 01 Capability

    Filter by ingredient

    Finds dishes based on your main ingredients. You can use this to see what you can cook with what's in your pantry.

  2. 02 Capability

    List meals by first letter

    Lists all meals starting with a specific letter of the alphabet. This is a simple way to browse the database.

  3. 03 Capability

    Filter by area

    Filters meals by specific geographic regions like Canada or Mexico. This helps you find authentic dishes from around the world.

  4. 04 Capability

    Get meal by id

    Fetches every detail for a specific meal using its unique ID. Use this when you have a specific recipe in mind and need the full details.

Capability set02 / 04

05—07

3 capabilities in this set.

Part of 13 available through TheMealDB.

  1. 05 Capability

    Get random meal

    Grabs one random recipe for when you just need a new idea. It's perfect for breaking out of a cooking rut.

  2. 06 Capability

    Get random meals selection

    Pulls a batch of 10 random meals for broader inspiration. This gives you a wider variety of ideas in one go.

  3. 07 Capability

    List all categories

    Shows every meal category with a brief description. It helps you see the full scope of the database.

Capability set03 / 04

08—10

3 capabilities in this set.

Part of 13 available through TheMealDB.

  1. 08 Capability

    List areas

    Provides a list of all browseable countries and regions. Use this to explore different global cuisines.

  2. 09 Capability

    List categories

    Lists simple categories like Beef, Chicken, or Dessert. This gives you a quick overview of common meal types.

  3. 10 Capability

    List ingredients

    Shows a list of all available ingredients in the database. It helps you see the variety of components available.

Capability set04 / 04

11—13

3 capabilities in this set.

Part of 13 available through TheMealDB.

  1. 11 Capability

    Search meals by name

    Searches for recipes using full or partial names. It's the fastest way to find a specific dish you're looking for.

  2. 12 Capability

    Filter by category

    Lets you find meals grouped by type, such as Seafood or Vegan. It makes it easy to browse specific food groups.

  3. 13 Capability

    Get latest meals

    Pulls the most recent additions to the recipe database. This is great for seeing what's new in the culinary world.

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_dhRtKcxtyaCQHzizhcQD8PboSErXP3PYFbLIO6nR/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

This is for the home cook tired of 'what's for dinner' stress, the food blogger needing consistent recipe data, and the app developer building the next big cooking capability.

01

Home Cook

Plans weekly meals based on available groceries and local flavor preferences.

02

Food Content Creator

Pulls high-quality recipe data for social media posts and food blogs.

03

App Developer

Integrates culinary data into a custom food app or meal planning service.

Build the capability set

Add more capabilities.

Each Connector adds new actions and data without changing how you work.

Browse Connectors
TheMealDB logo
01 10 capabilities

TheMealDB

Search recipes, browse ingredients, and discover meals from global cuisines via AI.

View Connector
Spoonacular logo
02 22 capabilities

Spoonacular

Search recipes, find meals by ingredients, and analyze nutritional data directly from your AI agent using the Spoonacular food database.

View Connector
BigOven logo
03 8 capabilities

BigOven

Access over a million recipes via BigOven. search dishes, read reviews, and explore collections directly from any AI agent.

View Connector
Edamam logo
04 3 capabilities

Edamam

Search over 2.3 million recipes, analyze nutritional data, and access a database of 900,000+ food items directly from your AI agent.

View Connector
Mealie (Recipe Manager) logo
05 13 capabilities

Mealie (Recipe Manager)

Manage your Mealie recipes, meal plans, and shopping lists directly through your AI agent.

View Connector

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 plan my weekly meals?

Yes, it can. You can ask your agent to find recipes based on specific regions, categories, or ingredients to help you build a structured weekly menu.

How does TheMealDB MCP find recipes for specific ingredients?

It searches the database for dishes where your chosen items are the main components, providing you with a list of options you can cook right now.

Can I use TheMealDB MCP to find international recipes?

Absolutely. You can browse by specific areas like Italy, Mexico, or Canada to find authentic dishes from different parts of the world.

Is TheMealDB MCP good for food bloggers?

It's a great resource for content creators. You can quickly pull structured data for various meal categories to gather inspiration or data for your blog.

How do I get random meal ideas with TheMealDB MCP?

You can simply ask your agent for a random meal suggestion. It will pull a single recipe or a selection of ten to give you some new ideas.

Can TheMealDB MCP provide full cooking instructions?

Yes, it provides complete details including precise measurements and step-by-step instructions for the recipes it finds.

How do I get the full cooking instructions for a specific meal?

Use the get_meal_by_id capability with the unique Meal ID. The agent will return the full recipe, including step-by-step instructions and a complete list of ingredients with measurements.

Can I search for recipes based on what I have in my fridge?

Yes! You can use the filter_by_ingredient capability to find meals that feature a specific main ingredient. For Premium V2 users, you can even provide a comma-separated list of multiple ingredients.

What is the difference between the free and premium API access?

The free tier (API key '1') allows standard searching and filtering. Premium V2 access enables advanced capabilities like get_latest_meals, get_random_meals_selection (10 at once), and multi-ingredient filtering.

One connection away

Give your agent a direct line to TheMealDB.

Connect TheMealDB once. Keep it beside 6,100+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available