| name | kroger |
| description | Search Kroger products and add items to a Kroger cart via the Kroger API. Use when a user asks to find groceries, add items to their Kroger cart, look up Kroger store locations, or manage a Kroger shopping list. Supports product search, cart management, and store lookup by zip code. |
Kroger
Search products, add to cart, and find store locations via the Kroger public API.
Prerequisites
- Kroger developer account at https://developer.kroger.com
- Registered application with Product and Cart API access
- OAuth redirect URI configured in the Kroger app settings
Environment Variables
Set these before using:
export KROGER_CLIENT_ID="your-client-id"
export KROGER_CLIENT_SECRET="your-client-secret"
Optional:
KROGER_TOKEN_FILE — token storage path (default: ~/.kroger-tokens.json)KROGER_REDIRECT_URI — OAuth callback URL (default: http://localhost:8888/callback)KROGER_LOCATION_ID — store ID for location-specific product availability
Setup (One-Time)
1. Register a Kroger Developer App
- Go to https://developer.kroger.com
- Create an application
- Enable Product and Cart scopes
- Set redirect URI to
http://localhost:8888/callback
- Note Client ID and Client Secret
2. Authenticate
Run the auth flow — opens a browser for Kroger login:
scripts/kroger.sh auth
If the redirect URI isn't localhost (e.g., cloud-hosted), use the manual flow:
- Open the
AUTH_URL printed by scripts/kroger.sh auth
- Log in at Kroger
- Copy the redirected URL (even if the page errors)
- Extract the
code parameter and run:
scripts/kroger.sh exchange <code>
Tokens auto-refresh. Re-auth only needed if refresh token expires.
Actions
Search products
scripts/kroger.sh search "cannellini beans"
Returns up to 5 results with product IDs, descriptions, and brands.
Add to cart
scripts/kroger.sh add <productId> [quantity]
Requires prior OAuth login. Quantity defaults to 1.
Find nearby stores
scripts/kroger.sh locations <zipcode>
Returns up to 5 stores with location IDs. Set KROGER_LOCATION_ID to filter product search by store.
Check auth status
scripts/kroger.sh token
Workflow: Grocery List → Cart
Typical flow for adding a grocery list to Kroger:
- Search each item:
scripts/kroger.sh search "<item>"
- Pick the best match from results
- Add to cart:
scripts/kroger.sh add <productId> <qty>
- Repeat for all items
When adding many items, batch all searches first, then confirm selections with the user, then add all to cart.
