Harris Teeter grocery pickup — search, cart, pickup times and checkout via your browser
About
Harris Teeter grocery pickup — search, cart, pickup times and checkout via your browser
Security Report
The harristeeter-mcp server drives the user's own signed-in harristeeter.com browser tab through the ContextMint Bridge rather than storing credentials, and it explicitly stops short of placing orders, with confirmation gating on writes. Findings are limited to code-quality and disclosure items: a dependency on a third-party bridge extension that carries session cookies, pharmacy data access, and the truncated pharmacy file that could not be fully reviewed. Permissions broadly match a grocery and pharmacy assistant's purpose. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.
5 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: HARRISTEETER_WS_PORT
Environment variable: HARRISTEETER_DEBUG
Environment variable: MCP_USER_TZ
Environment variable: KROGER_API_CLIENT_ID
Environment variable: KROGER_API_CLIENT_SECRET
Environment variable: HARRISTEETER_LOCATION_ID
Environment variable: HARRISTEETER_STATE_DIR
Environment variable: FETCHPROXY_WS_HOST
Environment variable: FETCHPROXY_IDENTITY_DIR
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"harristeeter-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/harristeeter-mcp@0.3.0"
],
"env": {
"MCP_USER_TZ": "your-mcp-user-tz-here",
"FETCHPROXY_WS_HOST": "your-fetchproxy-ws-host-here",
"HARRISTEETER_DEBUG": "your-harristeeter-debug-here",
"HARRISTEETER_WS_PORT": "your-harristeeter-ws-port-here",
"KROGER_API_CLIENT_ID": "your-kroger-api-client-id-here",
"HARRISTEETER_STATE_DIR": "your-harristeeter-state-dir-here",
"FETCHPROXY_IDENTITY_DIR": "your-fetchproxy-identity-dir-here",
"HARRISTEETER_LOCATION_ID": "your-harristeeter-location-id-here",
"KROGER_API_CLIENT_SECRET": "your-kroger-api-client-secret-here"
}
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
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.
- Install the ContextMint Bridge extension and sign in at https://www.harristeeter.com.
- Add the server (below) and call
ht_healthcheck. - 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:
- a
ziporlocationIdyou pass for that one search; - the store you saved with
ht_set_store("use my Park Road store"); HARRISTEETER_LOCATION_ID;- 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;
- 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
| Tool | What it does |
|---|---|
ht_search_products | Search at your pickup store: UPC, name, brand, size, price, sale price, unit price, stock |
ht_get_products | Look up UPCs |
ht_find_stores | Harris Teeter stores near a ZIP, with the 8-digit location id (needs Kroger API credentials) |
ht_get_cart | Cart with names, prices, estimated subtotal |
ht_add_to_cart | Add items by UPC (adds to existing quantity) |
ht_update_cart_item | Set quantity / substitution preference (0 removes) |
ht_remove_from_cart | Remove items |
ht_get_store | Your pickup store, and the store search prices against |
ht_set_store | Choose the search store by ZIP, name or location id (or clear it) |
ht_list_timeslots | Open pickup windows and fees for the cart |
ht_start_checkout | Confirmation-gated. Reserve a window and create the checkout, returning totals and the place-order link |
ht_get_checkout | The current checkout draft |
ht_list_orders | Past purchases and receipts (each with a receiptKey) |
ht_get_receipt | One purchase in full: items, price paid, savings, totals |
ht_list_upcoming_orders | Orders placed but not yet picked up |
ht_list_coupons / ht_clip_coupon / ht_unclip_coupon | e-VIC digital coupons |
ht_list_specials | Your personalised My Specials |
ht_get_weekly_ad | This week's ad, by department or text |
ht_get_fuel_points | Fuel points balance and expiry |
ht_search_recipes / ht_get_recipe | Recipes, with store products matched to ingredients |
ht_list_shopping_lists / ht_get_shopping_list / ht_create_shopping_list / ht_rename_shopping_list / ht_delete_shopping_list | Shopping lists (delete is confirmation-gated) |
ht_add_to_shopping_list / ht_remove_from_shopping_list | Add or remove list items by UPC |
ht_oa_list_departments / ht_oa_list_menu / ht_oa_get_item / ht_oa_list_pickup_times | Order Ahead menus and pickup times |
ht_oa_place_order | Confirmation-gated. Place an Order Ahead order, paid at pickup. Not yet verified against a live order. |
ht_rx_session / ht_rx_list_prescriptions | Pharmacy: session status, prescriptions, refills remaining, due dates |
ht_rx_request_refill | Confirmation-gated. Request a refill, paid at the pharmacy. Not yet verified against a live refill. |
ht_healthcheck | Bridge status |
Cart tools change only your cart and can be undone, so they run without confirmation.
ht_start_checkout reserves a pickup window, so it previews first and acts only when called
again with the returned confirmToken.
Pharmacy needs its own sign-in
Opening harristeeter.com/rx asks you to sign in again (with a one-time code the first time on a
browser). Pharmacy access then lasts one hour from sign-in, and nothing extends it. When it
lapses the ht_rx_* tools say so; sign in again at https://www.harristeeter.com/rx/dashboard.
If a pharmacy tab is open when the hour ends, the site signs you out of harristeeter.com
entirely, so the grocery tools need a fresh sign-in too. Keep a regular harristeeter.com tab open as well, because
the bridge can't send some requests from a pharmacy page.
Why it can't press "Place Order"
The site submits orders to a separate payment host from a hosted payment frame that attaches its own token plus fraud-screening and bot-detection data. Sending that from a server would mean faking those signals, so the final click stays with you. See docs/HT-API.md.
Configuration
| Variable | Default | |
|---|---|---|
HARRISTEETER_WS_PORT | 37149 | fetchproxy concentrator port, shared by the whole fleet. Change only if you know why. |
KROGER_API_CLIENT_ID / KROGER_API_CLIENT_SECRET | unset | Optional Kroger developer app: search and prices without the browser |
HARRISTEETER_LOCATION_ID | unset | 8-digit store id for bridge-free search (below a saved ht_set_store choice) |
HARRISTEETER_STATE_DIR | ~/.harristeeter-mcp | Where the saved and remembered store are kept |
HARRISTEETER_DEBUG | unset | 1 for verbose bridge logging to stderr |
MCP_USER_TZ | America/New_York | IANA zone sent with pickup-time requests |
MCP_CONFIRM_MODE | ask-user | ask-user (the model must get your OK in chat before using a token), auto, or refuse |
MCP_CONFIRM_ELICITATION | on | off skips the client's confirmation prompt even when it supports one |
MCP_CONFIRM_SECRET | random per process | Fixed key for confirm tokens, so a token survives a restart |
Skill
skills/harristeeter-fpx does the same reads and cart changes from a shell with the fpx CLI,
with no MCP server.
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.