# Mealie MCP for AI Agents AI Agent Connect

> Mealie (Recipe Manager) MCP lets you manage your recipes, meal plans, and grocery lists directly through your AI agent. It connects to your Mealie instance so you can organize ingredients, schedule your week's meals, and check off items in the store without switching tabs.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_BnbsdJueZVsBOC2FT7R5AenxO9rtMf4l6pWw6A2Y/ai-agent-connect
- **Tags:** recipe-management, meal-planning, shopping-list, cooking, mealie

## Description

Mealie (Recipe Manager) lets you take full control of your kitchen workflow by connecting your existing recipe database to your AI agent. Instead of digging through a complex web interface to find that one specific lasagna recipe from three years ago, you just ask your agent to pull it up. It knows your categories, your tags, and your specific instructions. You can have your agent build out a full weekly menu based on what you have on hand, or even draft a grocery list for your next trip to the store. If you're someone who treats meal planning like a project, this is how you manage that project. You can organize your database, update your favorite dishes, and keep your shopping lists current without ever leaving your chat window. By connecting your instance to the Vinkius catalog, you turn your AI into a digital sous-chef that remembers every ingredient and every planned meal. It handles the heavy lifting of organization so you can focus on the actual cooking. You no longer have to worry about forgetting a step in a complicated sauce or losing track of what you need to buy for your weekly haul. Everything you need to run a smooth kitchen is available in one conversation. Whether you are trying to stick to a strict diet or just want to find a new way to use that bag of spinach, your agent provides the answers instantly.

## Tools

### delete_recipe
Delete a recipe from your database. This keeps your collection clean by removing old or incorrect entries.

### get_recipe
Get a specific recipe by its slug. You can see all ingredients and instructions instantly without leaving your chat.

### update_recipe
Update an existing recipe. This is useful for changing serving sizes or ingredients.

### list_categories
List all categories in your Mealie instance. This helps you find the right type of meal quickly.

### list_meal_plans
List all meal plans. You can see what you are cooking for the rest of the week.

### list_recipes
List all recipes in your database. Use this to browse your entire collection at once.

### list_shopping_lists
List all shopping lists. You can check what you need for your next trip.

### list_tags
List all tags. This helps you filter recipes by specific dietary needs.

### toggle_shopping_list_item
Toggle a shopping list item. This keeps your grocery list updated in real time as you find items.

### create_meal_plan
Create a new meal plan entry. Use this to organize your upcoming dinners.

### create_recipe
Create a new recipe. This is the quickest way to save new meals you have tried.

### create_shopping_list
Create a new shopping list. You can create lists for weekly hauls or special parties.

### delete_meal_plan
Delete a meal plan entry. Use this to clear out plans that no longer work for your week.

## Prompt Examples

**Prompt:** 
```
What's on my meal plan for this week?
```

**Response:** 
```
You have 5 meals scheduled for this week. Here is the lineup:

| Day | Meal |
|---|---|
| Monday | Spicy Tacos |
| Tuesday | Classic Lasagna |
| Wednesday | Garden Salad |
| Thursday | Stir Fry |
| Friday | Homemade Pizza |

Would you like me to pull up the ingredients for tomorrow's dinner?
```

**Prompt:** 
```
Give me the ingredients for the 'Spicy Tacos' recipe.
```

**Response:** 
```
Here are the ingredients for **Spicy Tacos**:

*   Ground beef (1lb)
*   Taco shells
*   Shredded lettuce
*   Shredded cheese
*   Sour cream
*   Taco seasoning

It makes 4 servings. Do you want me to add these to your current shopping list?
```

**Prompt:** 
```
Create a new shopping list for a BBQ this weekend.
```

**Response:** 
```
I've created a new shopping list called **Weekend BBQ**. What items would you like to add to it?
```

## Capabilities

### Create new recipes
Add new dishes to your database with full ingredient lists and instructions.

### Pull up recipe details
Get ingredients and steps for any specific dish instantly.

### Build weekly meal plans
Schedule specific recipes for your calendar to organize your week.

### Manage grocery lists
Create and view shopping lists for different trips or events.

### Update shopping items
Toggle items as completed while you are walking through the store.

### Organize by category
Browse through your custom tags and categories to find meals quickly.

## Use Cases

### The Sunday Prep
A user asks the agent to look at their current meal plan and create a shopping list for the missing ingredients for the week.

### The Mid-Week Pivot
A cook asks for a quick pasta from their Italian category and then adds the ingredients to their current shopping list.

### The Recipe Refresh
A user wants to update the serving size on a lasagna recipe, so they ask the agent to use update_recipe to change it from 4 to 8.

### The Pantry Audit
A user asks the agent to list all items in their Weekly Groceries list and mark the ones they already have as done.

## Benefits

- Stop tab-switching by using get_recipe to see ingredients and instructions instantly while you are in the kitchen.
- Build your entire week of meals in seconds using create_meal_plan to handle the daily stress of choosing dinner.
- Keep your grocery runs organized by using create_shopping_list to group items by trip or specific event.
- Update your pantry status in real time with toggle_shopping_list_item as you put items in your cart at the store.
- Maintain a clean database by using update_recipe or delete_recipe to prune old dishes and keep your favorites front and center.
- Find the right meal for any occasion by using list_categories and list_tags to filter through your collection.

## How It Works

The bottom line is you get a hands-free way to manage your entire kitchen workflow from a single chat interface.

1. Subscribe to the Mealie MCP on Vinkius.
2. Enter your Mealie Instance URL and Personal API Token in your client settings.
3. Ask your agent to list recipes, build plans, or manage your shopping lists.

## Frequently Asked Questions

**Does the Mealie Recipe Manager work with my existing account?**
Yes, it connects directly to your current Mealie instance using your URL and API token. You can keep all your existing data while gaining AI access.

**Can I use this to build my weekly meal plan?**
You can ask your agent to create and schedule meals for specific dates, making it easy to plan your week without manual entry.

**How do I add new recipes to my list?**
Just tell your agent to create a new recipe and provide the details like ingredients and instructions. It will save them to your database automatically.

**Can it help me while I'm at the grocery store?**
You can ask your agent to toggle items off your shopping list as you find them in the aisles, keeping your list updated in real time.

**Does this Connector work with Claude and Cursor?**
Yes, it works with any AI client that supports the Model Context Protocol, including Claude, Cursor, and Windsurf.

**Is this for professional chefs or just home cooks?**
It is great for anyone who manages a recipe database, from home cooks to organized meal planners who want to streamline their kitchen workflow.

**How can I see the full instructions for a specific recipe?**
You can use the `get_recipe` tool by providing the recipe's unique slug. The agent will return the full details, including ingredients, steps, and yield.

**Can I mark items as 'bought' on my shopping list using the AI?**
Yes! Use the `toggle_shopping_list_item` tool. You just need the shopping list ID and the item ID to check or uncheck items remotely.

**Is it possible to see what I have planned for dinner this week?**
Absolutely. The `list_meal_plans` tool retrieves all scheduled entries, allowing your AI to summarize your upcoming meals for the week.