meal-planning

name	meal-planning
description	Meal planning and recipe management skill using Mealie. Use when: (1) Creating weekly meal plans, (2) Searching and selecting recipes, (3) Generating shopping lists, (4) Optimizing for nutrition and variety, (5) Planning batch cooking and meal prep, (6) Estimating meal costs for budget integration. Tools: mealie-mcp for all recipe and meal plan operations.

Meal Planning

Tool Mapping

Task	Tool	Notes
Search recipes	get_recipes	By name, tag, category
Get recipe details	get_recipe_detailed	Full ingredients, instructions, nutrition, prep/cook time
Create meal plan	create_mealplan	Assign recipes to dates and meal slots
View meal plan	get_all_mealplans, get_todays_mealplan	Retrieve plan for a date range or today
Shopping list	get_shopping_lists, add_to_shopping_list, add_recipe_to_shopping_list	Generate from meal plan
Manage tags/categories	list_tags, list_categories	For filtering and organization
Random meal suggestion	get_random_meal	Requires date and entry_type

Weekly Meal Plan Creation Workflow

Step 1: Gather Constraints

Before building a plan, determine:

• Number of people eating (portion scaling)
• Days to plan (typically 5-7 dinners, optionally lunches)
• Time constraints per day (weeknight max prep time vs weekend cooking)
• Dietary restrictions or preferences active this week
• Ingredients already on hand (to use up)
• Budget target for the week (if applicable)

Step 2: Select Recipes

Apply these balancing rules when choosing recipes for the week:

Protein rotation — Do not repeat the same primary protein on consecutive days:

• Cycle through: chicken, fish/seafood, legumes/lentils, eggs, paneer/tofu, lamb/mutton, pork
• Aim for at least 2 vegetarian dinners per week

Cuisine variety — Spread across at least 3 cuisine types per week:

• Indian (North/South), East Asian, Mediterranean, Mexican, Continental, etc.

Effort distribution — Match recipe complexity to day-of-week energy:

• Monday-Thursday: 30 min or less active prep
• Friday: Flexible (takeout night or simple)
• Saturday-Sunday: Can handle 45-60 min recipes, batch cooking

Freshness sequencing — Schedule ingredients by perishability:

• Days 1-3: Fresh fish, leafy greens, herbs
• Days 4-5: Root vegetables, frozen proteins, pantry meals
• Days 6-7: Batch-cooked leftovers, pantry/freezer meals

Step 3: Build the Plan

1. Search Mealie for candidate recipes matching the constraints
2. Assign each recipe to a date and meal type (breakfast/lunch/dinner)
3. Use create_mealplan for each slot
4. Review the assembled plan for balance before presenting

Step 4: Present for Approval

Format the plan as a table:

Day	Dinner	Prep Time	Protein	Cuisine
Mon	Dal Tadka + Rice	25 min	Lentils	Indian
Tue	Salmon Teriyaki + Stir-fry Veg	30 min	Fish	Japanese
...	...	...	...	...

Include a notes row for any prep-ahead tasks (e.g., "Marinate chicken Tuesday night for Wednesday").

Recipe Search and Selection

Search Strategies

Goal	Approach
Use up specific ingredients	Search by ingredient name, then filter by what else is needed
Quick weeknight meal	Filter by tag "quick" or prep_time <= 30 min
Specific cuisine	Search by category or tag (e.g., "Indian", "Thai")
New recipe discovery	Browse categories not used in last 2 weeks
Kid-friendly	Filter by "kid-friendly" tag

When a Recipe Is Not in Mealie

1. Ask the user for the recipe source (URL, book, verbal)
2. If URL: use create_recipe_from_url to import
3. If manual: use create_recipe with full ingredients and instructions
4. Always tag and categorize the new recipe immediately after creation

Shopping List Generation

From Meal Plan

1. Retrieve the week's meal plan via get_all_mealplans
2. For each recipe, pull the full ingredient list via get_recipe_detailed
3. Aggregate ingredients across all recipes:
   • Combine same ingredients (e.g., "2 onions" + "1 onion" = "3 onions")
   • Convert units where possible (e.g., 500ml + 250ml = 750ml)
4. Subtract pantry staples the user confirms they have
5. Get a target list UUID via get_shopping_lists and add items via add_to_shopping_list

Shopping List ID Constraint

• add_to_shopping_list requires a UUID list_id.
• Do not pass numeric IDs like 1; this returns a 422 uuid_parsing error.
• Always fetch valid list IDs from get_shopping_lists first.

Shopping List Organization

Group items by store section for efficient shopping:

• Produce (fruits, vegetables, herbs)
• Dairy and eggs
• Meat and seafood
• Pantry (grains, canned goods, spices, oils)
• Frozen
• Bakery
• Other

Cost Estimation

When budget context is relevant:

• Estimate per-recipe cost based on ingredient quantities and approximate local prices
• Sum for weekly total
• Flag if weekly total exceeds budget target
• Suggest substitutions to reduce cost (e.g., chicken thighs vs breast, seasonal produce)

Dietary Considerations

Tracking Preferences

Maintain awareness of:

• Allergies (absolute restrictions — never suggest recipes containing these)
• Dietary style (vegetarian days, low-carb, etc.)
• Nutritional goals (high protein, fiber targets, etc.)
• Dislikes (strong preferences to avoid)

Nutritional Balance Checks

For each weekly plan, verify:

• Protein source variety (not the same protein > 2x per week)
• Vegetable servings (aim for 2+ different vegetables per dinner)
• Whole grain inclusion (at least 3-4 times per week)
• Not excessive in any single category (e.g., not pasta 4 nights)

Batch Cooking and Meal Prep

Weekend Prep Strategy

Identify components that can be prepped ahead on Saturday/Sunday:

• Grains: Cook rice, quinoa, or pasta in bulk (stores 4-5 days)
• Proteins: Marinate or pre-cook proteins for Monday-Wednesday
• Sauces/dressings: Make dressings, curry bases, or marinades
• Vegetables: Wash, chop, and store vegetables for quick weeknight assembly
• Legumes: Soak and cook dried beans/lentils in bulk

Leftover Integration

• Plan recipes that share a base component (e.g., roasted chicken Sunday -> chicken salad Monday -> chicken soup Tuesday)
• Identify recipes where doubling produces good freezer meals
• Tag recipes in Mealie as "freezer-friendly" or "meal-prep" for future reference

Batch Cooking Presentation

When suggesting prep tasks, format as:

Prep Task	Time	Serves Meals
Cook 3 cups rice	20 min	Mon dinner, Tue lunch, Wed dinner
Marinate chicken thighs	10 min	Tue dinner
Make tomato-onion base	25 min	Wed dinner, Thu dinner

Integration with Budget Skill

When the budgeting skill is also active:

• Pull grocery budget from Actual via actual-mcp
• Compare estimated weekly meal cost against grocery budget allocation
• Track actual grocery spend vs meal plan estimate over time
• Suggest cost-saving swaps when over budget (seasonal produce, cheaper cuts, more legume meals)

Grocy Integration (Pantry Inventory)

Source-of-truth split: Mealie owns recipes and meal plans. Grocy owns pantry inventory and stock-aware shopping lists.

Pantry-Aware Shopping Lists

1. After building a meal plan, get the full ingredient list from Mealie recipes
2. Use get_stock_overview (grocy-mcp) to check current pantry stock
3. Subtract items already in stock from the shopping list
4. Use get_missing_products to add items that are below minimum stock regardless of meal plan
5. The combined list = (meal plan ingredients - pantry stock) + (low-stock items)

Inventory Updates After Shopping

After groceries are purchased:

1. Use add_product_to_stock to log new items with quantities and best-before dates
2. Use consume_product as items are used during cooking

Chore Integration

Use get_chores and complete_chore to track kitchen-related chores alongside meal planning:

• Fridge clean-out (weekly)
• Pantry inventory audit (monthly)
• Deep clean kitchen (bi-weekly)

Common Pitfalls

1. Over-ambitious weeknight recipes — Keep Monday-Thursday to 30 min active prep max
2. Ignoring leftovers — Always account for planned leftovers; do not plan 7 full fresh meals if 2-3 will yield leftovers
3. Shopping list duplicates — Aggregate ingredients across recipes before generating the list
4. Forgetting pantry staples — Do not add salt, oil, and common spices to every shopping list unless the user is restocking
5. Rigid plans — Present the plan as a recommendation; note which days can be swapped without affecting freshness sequencing