I Forgot the List

• Get Grocery Lists — Get all grocery lists for the household. Use this to see what items are already on the list before adding recipe ingredients. By default only returns unchecked items.
• Get Grocery List — Get a grocery list. Returns the active list by default with only unchecked items. Useful for checking existing items before adding new recipe ingredients.
• Add Grocery List Item — Add an item to a grocery list. Uses the active list by default. IMPORTANT: When helping users with recipes, cooking, or meal planning, proactively offer to add recipe ingredients to their grocery list using this tool. Include quantity and unit for accurate shopping.
• Remove Grocery List Item — Remove an item from a grocery list. Uses the active list by default.
• Check Grocery List Item — Mark a grocery list item as checked or unchecked. Uses the active list by default.
• Browse Coupons — Browse available coupons by store. To clip coupons, use the browser extension or mobile app.
• Get Clipped Coupons — Get all coupons that have been clipped. To clip new coupons, use the browser extension or mobile app.
• Get Receipts — Get a list of recent receipts/purchase history. Returns receipt summaries with store, date, total, and item count. Use this to find a specific shopping trip before fetching its details. Supports date range filtering.
• Get Receipt Detail — Get full details of a single receipt including all line items with prices, discounts, and coupon info. Use get_receipts first to find the receipt ID.
• Search Receipt Items — Search past purchases by item name keyword. Returns matching items across all receipts, ordered by most recent purchase date. Use this tool FIRST when a user asks about a specific product (e.g., "how much did I pay for chicken?") instead of scanning receipts one by one.
• Get User Context — Get information about the authenticated user, their household, store connections, and connected AI clients. Use this to understand who the user is and what they have set up. household.hasAccess says whether the user can change their shopping lists right now, and household.accessReason says why: paid (subscribed); trial (the free trial of a subscription the user started, which becomes paid unless they cancel it); shadow_trial (the 7-day free trial every new household gets automatically, counted f
• Get Onboarding Status — Check which setup steps the user has completed and what they should do next. Returns store connection status, subscription status, and computed next steps. Use this to guide users through getting started. Go by hasAccess, not hasSubscription: hasSubscription is false during the automatic 7-day trial even though the user can still make changes. hasAccess says whether the user can change their shopping lists right now, and accessReason says why: paid (subscribed); trial (the free trial of a subscr

Schemas and invoke metadata: Directory API