All shopping lists on the account, with their ListIDs.

Use when the user has several lists ("weekend BBQ", "pharmacy") — every other tool takes an optional list_id to target one; without it they use the default list (the pinned --list-id, or the account's first list).

Fetch the grocery list. Call this FIRST before editing/deleting, to get ItemIDs.

Checked items ([x]) = the user most likely already HAS them at home. Unchecked items ([ ]) = still to buy.

Args: list_id: which list (from get_lists). Empty = the default list.

Add one or MANY items in a single call — batch whole recipes, don't loop.

Args: items: the items to add. list_id: which list (from get_lists). Empty = the default list.

Edit one or MANY items in a single call — most often to check/uncheck while shopping ("got the milk").

Args: items: edits to apply; only the fields you set are changed. list_id: which list (from get_lists). Empty = the default list.

Delete items entirely (not check off — that's edit_items with is_checked).

Args: item_ids: ItemIDs to delete (from get_items). list_id: which list (from get_lists). Empty = the default list.