Kroger Python API Toolkit
This documentation is for two unofficial, open-source Python packages that build on the Kroger Public API:
- kroger-api is a Python client. It handles authentication via client credentials, authorization code, and PKCE. It also covers locations, products, carts, and identity, while managing token storage and refresh automatically.
- kroger-mcp is a Model Context Protocol server built on kroger-api. It lets AI assistants use these capabilities as tools, with a human (optionally) approving each tool call.
Kroger is a family of grocery banners across the United States. The Public API reaches stores and products across banners including Kroger, Ralphs, King Soopers, City Market, Fred Meyer, QFC, Fry's, Smith's, Dillons, Baker's, Gerbes, Harris Teeter, Mariano's, Pick 'n Save, Metro Market, JayC, Pay Less, Ruler Foods, Food 4 Less, and Foods Co.
Where to start
| You want to... | Go to |
|---|---|
| Make your first API call and end with an item in a real cart | Tutorial: Use the Kroger API in Python |
| Give an AI assistant grocery capabilities | Lab: Build an AI agent with kroger-mcp |
| Solve a specific task (auth flows, refresh, rate limits) | How-to guides |
| Understand how the client is put together | Concepts |
| Look something up | Reference |