add_meal_plan_item
ChatGPTAdd a recipe or placeholder to a meal section on a specific day (YYYY-MM-DD). Works whether or not a plan exists yet. Adding to an empty section makes it that meal's main dish; use asMain to promote when the section already has a main. Confirm with the user first.
create_instacart_shopping_link
ChatGPTOpen the week's grocery list on Instacart for one-tap shopping. Use when the user wants to buy groceries, shop the list, or get an Instacart link. Call get_grocery_list first for the same targetDate when the list may be missing or stale.
create_meal_plan
ChatGPTCreate a week meal plan for the week containing targetDate if one does not already exist. If a plan already exists for that week, returns it without overwriting. Confirm with the user before creating.
create_recipe
ChatGPTSave a recipe from structured fields when the user dictates one or URL import failed. Requires title, at least one ingredient line, and at least one instruction. The recipe saves immediately; MyMealVault tidies wording and computes nutrition in the background.
delete_recipe
ChatGPTDelete a saved recipe by recipeId. Removes it from meal plans. Confirm with the user before deleting.
duplicate_meal_plan_item
ChatGPTCopy a meal plan item to another day/section while keeping the original. Confirm with the user first.
get_grocery_list
ChatGPTGet the grocery list for the week containing targetDate (YYYY-MM-DD). If the list is missing or the meal plan is newer, MyMealVault creates or resyncs it and preserves checked items and custom additions. After presenting the list, offer Instacart checkout when the user wants to shop; call create_instacart_shopping_link with the same targetDate only after they agree.
get_household_preferences
ChatGPTGet household size, dietary preferences, planning mode, and grocery settings.
get_meal_plan
ChatGPTGet the full meal plan for the week containing targetDate (YYYY-MM-DD, defaults to today). Call exactly once per user question. The response includes recipe titles and thumbnails for all planned items; never call get_recipe to resolve entries from this plan.
get_recipe
ChatGPTGet full detail for one saved recipe by recipeId. Call this after an import completes to confirm and display the saved recipe.
get_recipe_import_status
ChatGPTCheck a URL import job by importJobId. status is queued, processing, completed, or failed. queued and processing are NOT done: when you see them, wait about 3-5 seconds and call this tool again, and keep polling. Do not end your turn or tell the user it succeeded while status is queued or processing. Imports can take up to about 2 minutes; keep polling for that full window (about 24-30 attempts). If it is still not terminal after 2 minutes, tell the user it is taking longer than expected and to ask you to check again in a moment. When status is completed with a recipeId, call get_recipe for that recipeId and confirm the recipe is saved (not that a job was queued). When status is failed, explain the failure and offer to save it with create_recipe from structured fields.
import_recipe_from_url
ChatGPTPreferred when the user has a recipe link. Starts an async import and returns importJobId immediately; this does NOT mean the recipe is saved yet. Next, poll get_recipe_import_status with that importJobId about every 3-5 seconds for up to 2 minutes, until status is completed or failed. Do not tell the user it succeeded until the job is completed and get_recipe confirms the saved recipe. If import fails, save with create_recipe using structured fields.
move_meal_plan_item
ChatGPTMove an item from one day/section to another, optionally swapping with a target item. Confirm with the user first.
remove_meal_plan_item
ChatGPTRemove one item from a meal section or clear a single-section meal. Confirm with the user first because this deletes planned entries.
replace_meal_plan_item
ChatGPTReplace an existing item in a meal section with a new recipe or placeholder. Confirm with the user first.
search_my_recipes
ChatGPTSearch and filter recipes saved in the user's MyMealVault vault. Returns a bounded summary list (default 20 results, max 50 per call).
update_recipe
ChatGPTCorrect a saved recipe by naming fields to change. Omitted fields are preserved. Confirm with the user before updating.
