Weekly Meal Planner
plan_weekRead-onlyIdempotent
Plan my meals for the week. Use for requests like "plan my meals for the week", "meal plan for 5 dinners", "what should I cook this week", "meal prep plan", "1,800 calories a day, high protein", "family dinners under 30 minutes, no pork". Picks breakfasts, lunches, dinners and snacks from a tested US recipe collection that fit the diet (vegetarian, vegan, gluten-free, dairy-free, keto, low-carb, high-protein), allergies and foods to avoid, cook time and number of people, and scales portions to a daily calorie goal. Calories and macros come from USDA FoodData Central, never estimated. Returns a day-by-day plan plus a plan_id; then call build_shopping_list with the plan_id for the grocery list and checkout link.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | How many days to plan (1-7). '5 dinners' = days 5, meals ['dinner']. | |
| diet | No | Diet preferences every meal must satisfy. | |
| seed | No | Change to get a different plan with the same constraints. | |
| meals | No | Which meals to plan each day. | |
| people | No | How many people you're cooking for (scales the grocery list). | |
| exclude | No | Foods to leave out, in plain words: "pork", "shellfish", "dairy", "gluten", "peanuts", "mushrooms", "cilantro". Matches allergen tags and ingredient names. | |
| cuisines | No | Preferred cuisines, e.g. ["Mexican", "Italian"]. Soft preference. | |
| daily_calories | No | Calorie goal per person per day, e.g. 2000. Portions are scaled to hit it. | |
| max_cook_minutes | No | Max total prep + cook time per meal, e.g. 30 for quick weeknight meals. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | Yes | ||
| notes | Yes | ||
| people | Yes | ||
| plan_id | Yes | Pass to build_shopping_list to get the grocery list and checkout link. | |
| nutrition_source | Yes | ||
| daily_calorie_goal | Yes | ||
| average_daily_per_person | Yes |