Pantry Agent

An MCP (Model Context Protocol) server for grocery shopping at Kroger-owned stores. Search products, find stores, check prices, and manage your cart through AI assistants like Claude.

Works with all Kroger-owned banners: Kroger, Ralphs, Fred Meyer, King Soopers, Harris Teeter, Food 4 Less, Fry's, Smith's, QFC, Mariano's, Pick 'n Save, and more — covering ~2,800 stores across the US.

Features

• Product Search - Search by name, brand, or description at any Kroger-owned store
• Store Finder - Find nearby stores across all Kroger banners
• Product Details - Get pricing, stock availability, and nutrition info
• Cart Management - Add items to your cart (requires authentication)
• Profile Access - View your account profile

Installation

Claude Code

claude mcp add pantry-agent -- npx -y @blanxlait/pantry-agent

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "pantry-agent": {
      "command": "npx",
      "args": ["-y", "@blanxlait/pantry-agent"]
    }
  }
}

Authentication

For cart and profile features, authentication is automatic. When you use a feature that requires login, a browser window will open for Kroger authentication.

Tokens are stored locally at ~/.pantry-agent/tokens.json. To manage authentication:

npx @blanxlait/pantry-agent auth --status   # Check if logged in
npx @blanxlait/pantry-agent auth --logout   # Clear stored tokens

Available Tools

| Tool | Description | Auth Required | | ----------------- | --------------------------- | ------------- | | search_products | Search products by term | No | | get_product | Get product details by ID | No | | find_stores | Find stores near a ZIP code | No | | get_store | Get store details and hours | No | | add_to_cart | Add items to cart | Yes | | get_profile | Get user profile | Yes |

Example Usage

Once configured, you can ask Claude things like:

• "Search for organic milk at my local Kroger"
• "Find grocery stores near 90210" (returns Ralphs, Food 4 Less, etc.)
• "What are the nutrition facts for this product?"
• "Add 2 gallons of milk to my cart"
• "Find me a Ralphs in San Diego and search for avocados"

Requirements

• Node.js 20 or later
• A Kroger account (for cart/profile features — works with any Kroger-owned banner login)

Privacy

• Product search and store lookup work without authentication
• Cart and profile features require Kroger OAuth login
• Tokens are stored locally on your machine
• No data is sent to third parties

Disclaimer

Pantry Agent is not affiliated with, endorsed by, or sponsored by The Kroger Co.

License

MIT