harristeeter-mcp

Harris Teeter for Claude: search groceries with prices at your store, build the cart, pick a pickup window and start checkout, clip digital coupons, read the weekly ad and your specials, check fuel points and past receipts, find recipes, manage shopping lists, browse and order from Order Ahead (deli, subs, pizza, platters), and check your prescriptions. You place grocery orders yourself on harristeeter.com. The MCP stops at a draft checkout with the real totals and hands you the link.

This project was developed and is maintained by AI (Claude Code). Use at your own discretion.

How it reaches Harris Teeter

harristeeter.com is Kroger's web platform behind Akamai bot protection, and it answers only a real browser. Every request therefore runs inside your own signed-in harristeeter.com tab through the ContextMint Bridge extension (the fetchproxy bridge), reusing your session. There are no credentials to configure.

1. Install the ContextMint Bridge extension and sign in at https://www.harristeeter.com.
2. Add the server (below) and call ht_healthcheck.
3. Approve the pair code it shows in the extension popup, once.

If a second browser also runs ContextMint Bridge, stderr will show a fresh pair code on every call even though the call succeeds. Don't approve those; that's the other browser being refused.

Without the browser: Kroger's official API (optional)

Product search, prices and store lookup can run without the bridge through Kroger's official API. Register an app at developer.kroger.com and set KROGER_API_CLIENT_ID and KROGER_API_CLIENT_SECRET. ht_search_products, ht_get_products and ht_find_stores then call api.kroger.com directly, pricing against a store chosen in this order:

1. a zip or locationId you pass for that one search;
2. the store you saved with ht_set_store ("use my Park Road store");
3. HARRISTEETER_LOCATION_ID;
4. the store last seen in your browser, remembered whenever the bridge reads it, so the server keeps pricing at your store when the browser is closed;
5. your browser's store, read live through the bridge.

ht_get_store shows which one is in use and why. Cart, pickup times and checkout always use the store chosen on harristeeter.com. Results have the same fields either way and say which source served them; the API prices produce per pound, and each API result says so. Everything else (cart, checkout, coupons, lists, Order Ahead, pharmacy) still needs the bridge: Kroger's API sign-in doesn't accept Harris Teeter accounts, so it can't act on your account.

Install

{
  "mcpServers": {
    "harristeeter": { "command": "npx", "args": ["-y", "@chrischall/harristeeter-mcp"] }
  }
}

Tools

... View full README on GitHub