manage_shopping
Manage shopping list items AND stores. Handles MULTIPLE items in ONE call.
TRIGGERS:
- ADD: 'add X', 'I need X', 'pick up X', 'buy X', 'out of X'
- REMOVE: 'remove X', 'don't need X', 'got X already'
- UPDATE: 'change quantity', 'set X to Y'
- CHECK: 'check off X', 'got X', 'bought X'
- UNCHECK: 'uncheck X', 'still need X'
- CLEAR: 'clear checked' (clearAll: false), 'clear the list' (clearAll: true)
- CREATE_STORE: 'create a store', 'add Costco store', 'new store'
- UPDATE_STORE: 'rename store', 'change store categories'
- DELETE_STORE: 'delete store', 'remove X store'
CATEGORY IDs (use exactly): produce, dairy, meat, seafood, deli, bakery, frozen, pantry, snacks, beverages, household, pet, other
manage_pantry
Add, remove, update, or mark pantry items as consumed. Handles MULTIPLE items in ONE call - do NOT call multiple times.
TRIGGERS:
- ADD: 'add X to pantry', 'I bought X', 'stock X', 'put away groceries'
- REMOVE: 'remove X', 'threw out X', 'X went bad', 'X expired'
- UPDATE: 'have X left', 'down to X', 'low on X'
- CONSUME: 'used X', 'finished the X', 'cooked with X'
- CLEAR_EXPIRED: 'clear expired', 'remove old items'
- ADD_LEFTOVER: 'leftover pizza', 'saved 2 containers of soup', 'made extra pasta', 'meal prep portions'
ADD_LEFTOVER vs ADD: Use add_leftover when food is from a cooked meal. Use add for store-bought groceries.
IMPORTANT: Pass ALL items in a single call using the items array. Never call this tool multiple times for the same request.
CATEGORY IDs (use exactly): fruits, vegetables, dairy, meat, seafood, deli, meat_alternatives, bread, pasta_rice_cereal, canned, frozen, snacks, beverages, condiments_spices, baking, household, pet, leftovers, other
manage_meal_plan
Set meals, plan the week, clear, or move meals.
TRIGGERS:
- SET: 'X for dinner', 'plan X for Monday', 'tacos tomorrow'
- SET_WEEK: 'plan my week', 'weekly meal plan', 'meal prep'
- CLEAR: 'clear Monday', 'remove dinner', 'reset meal plan'
- MOVE: 'move dinner to Tuesday', 'swap Monday and Wednesday'
find_recipes
Search and filter recipes with advanced options.
TRIGGERS:
- 'find recipes with X' / 'recipes using chicken'
- 'quick dinner ideas' / 'recipes under 30 minutes'
- 'recipes safe for everyone' → forAllProfiles: true
- 'what can I make now' → canMakeNow: true (auto-reads pantry)
Advanced search with pantry matching, dietary filtering, and collections.
manage_recipes
Manage recipes: save, update, delete, rate, batch operations, and share links.
ACTIONS:
- save: Save a recipe from GPT-generated content or cookbook photos
- save_urls: Import recipes from URLs (1-20 at once)
- update: Edit an existing recipe (servings, ingredients, steps, etc.)
- delete: Delete a recipe by name or ID
- delete_batch: Delete multiple recipes (by IDs, search query, or all)
- batch_save: Save 4+ recipes in one operation
- rate: Rate a recipe 1-5 stars
- share: Generate a shareable pantrypersona.com link
TRIGGERS:
- SAVE: 'save this recipe', user shares cookbook photo
- SAVE_URLS: user pastes recipe URL(s)
- UPDATE: 'change servings', 'edit my recipe', 'add ingredient'
- DELETE: 'delete my [recipe]', 'remove [recipe]'
- DELETE_BATCH: 'delete all recipes', 'remove my pasta recipes'
- BATCH_SAVE: user provides 4+ recipes at once
- RATE: 'rate [recipe] 5 stars'
- SHARE: 'share [recipe]', 'get a link', 'send this recipe'
IMPORTANT: Pass ALL items in a single call. Never call multiple times for the same request.
shop_for_meal_plan
Add meal plan ingredients to shopping list in ONE call.
TRIGGERS:
- 'add ingredients from my meal plan' / 'shop for my meals'
- 'what do I need to buy for this week'
- 'add [day]'s meal plan to [store]'
Automatically checks pantry and skips items you already have.