Check if authenticated with Costco. Shows token status and expiry.

Args: account: Account name (optional, uses default if empty). Use list_accounts to see all.

Save a refresh token obtained from a browser login session.

Use this to add a new account or update an existing one. The refresh token is valid for 90 days.

Args: refresh_token: The OAuth2 refresh token from Costco's Azure AD B2C account: Account name (e.g. "personal", "spouse"). Creates the account if new. If empty, uses default account.

List in-warehouse purchase receipts for a date range.

Returns receipt summaries with date, warehouse name, total, item count, and transaction barcode (use barcode with get_receipt_detail for full items).

Args: start_date: Start date as M/DD/YYYY (e.g. "1/01/2026"). Defaults to 90 days ago. end_date: End date as M/DD/YYYY (e.g. "3/31/2026"). Defaults to today. document_type: Filter: "all", "warehouse", "gas", "carwash". Defaults to "all". account: Account name (optional, uses default).

Get full itemized receipt detail for a warehouse purchase.

Returns all line items with descriptions, prices, quantities, tax flags, plus payment tender details and tax breakdown.

Args: barcode: Transaction barcode from list_warehouse_receipts account: Account name (optional, uses default).

List online Costco.com orders for a date range.

Returns order summaries with order number, date, total, status, and line items with descriptions and shipping info.

Args: start_date: Start date as YYYY-M-DD (e.g. "2026-1-01"). Defaults to 90 days ago. end_date: End date as YYYY-M-DD (e.g. "2026-3-31"). Defaults to today. warehouse_number: Warehouse number (default "847"). page_number: Page number for pagination (default 1). page_size: Results per page (default 25). account: Account name (optional, uses default).

Get full itemized details for ALL warehouse receipts in a date range.

Fetches the receipt list then retrieves full details for each one.

Args: start_date: Start date as M/DD/YYYY. Defaults to 90 days ago. end_date: End date as M/DD/YYYY. Defaults to today. account: Account name (optional, uses default).

Look up full Costco product names by item numbers.

Uses a shared local cache — only calls the API for uncached items.

Args: item_numbers: Comma-separated item numbers (e.g. "70476,5887,1532925") warehouse_number: Warehouse number (default "847") account: Account name (optional, uses default).