Texas Grocery

MCP server for HEB grocery store integration - search products, manage carts, clip coupons, and more

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "texas-grocery": {
      "command": "npx",
      "args": [
        "-y",
        "texas-grocery"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

🛒 Texas Grocery MCP

🤖 Let AI do your grocery shopping! An MCP server that connects Claude to H-E-B grocery stores.

Search products, manage your cart, clip coupons, and more — all through natural conversation.

⚠️ This project is not affiliated with H-E-B. It uses unofficial web APIs and browser automation against HEB.com; use responsibly and ensure your usage complies with applicable terms and laws.

✨ Features

Feature	Description
🏪 Store Search	Find HEB stores by address or zip code
🔍 Product Search	Search products with pricing and availability
🛒 Cart Management	Add/remove items with human-in-the-loop confirmation
📋 Product Details	Ingredients, nutrition facts, allergens, warnings
🎟️ Digital Coupons	List, search, and clip coupons to save money
🔄 Auto Session Refresh	Handles bot detection automatically (~15 seconds)

📦 Installation

Quick Start

Terminal

pip install texas-grocery-mcp

Full Installation (Recommended) 🚀

Terminal

pip install texas-grocery-mcp[browser]
playwright install chromium

This enables fast auto-refresh (~15 seconds) using an embedded browser.

Prerequisites

For cart operations and session management, you'll also need Playwright MCP:

Terminal

npm install -g @anthropic-ai/mcp-playwright

⚙️ Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@anthropic-ai/mcp-playwright"]
    },
    "heb": {
      "command": "uvx",
      "args": ["texas-grocery-mcp"],
      "env": {
        "HEB_DEFAULT_STORE": "590"
      }
    }
  }
}

Environment Variables

Variable	Description	Default
`HEB_DEFAULT_STORE`	Default store ID	None
`REDIS_URL`	Redis cache URL	None (in-memory)
`LOG_LEVEL`	Logging level	INFO

🎯 Usage Examples

🏪 Finding a Store

Code

User: Find HEB stores near Austin, TX

Agent uses: store_search(address="Austin, TX", radius_miles=10)

🔍 Searching Products

Code

User: Search for organic milk

Agent uses: store_change(store_id="590")
Agent uses: product_search(query="organic milk")

📋 Getting Product Details

Code

User: What are the ingredients in H-E-B olive oil?

Agent uses: product_search(query="heb olive oil")
Agent uses: product_get(product_id="127074")
# Returns: ingredients, nutrition facts, warnings, dietary attributes

The product_get tool returns:

🥗 Ingredients - Full ingredient statement
📊 Nutrition Facts - Complete FDA panel
⚠️ Safety Warnings - Allergen info and precautions
🌿 Dietary Attributes - Gluten-free, organic, vegan, kosher, etc.
📍 Store Location - Aisle or section

🛒 Adding to Cart

Code

User: Add 2 gallons of milk to my cart

Agent uses: cart_add(product_id="123456", quantity=2)
# Returns preview for confirmation

Agent uses: cart_add(product_id="123456", quantity=2, confirm=true)
# ✅ Added to cart!

🎟️ Clipping Coupons

Code

User: Find coupons for cereal

Agent uses: coupon_search(query="cereal")
Agent uses: coupon_clip(coupon_id="ABC123", confirm=true)
# ✅ Coupon clipped!

🔐 Session Management

HEB uses bot detection that expires every ~11 minutes. This MCP handles it automatically!

⚡ Fast Auto-Refresh (Recommended)

With [browser] support installed:

Code

Agent uses: session_refresh()
# ✅ Completes in ~10-15 seconds

🔑 Auto-Login

Save your credentials once for automatic login:

Code

Agent uses: session_save_credentials(email="you@email.com", password="...")
# Credentials stored securely in system keyring
# Future session refreshes will auto-login!

🧰 Available Tools

🏪 Store Tools

Tool	Description
`store_search`	Find stores by address
`store_change`	Set preferred store
`store_get_default`	Get current default store

🔍 Product Tools

Tool	Description
`product_search`	Search products with pricing
`product_search_batch`	Search multiple products (up to 20)
`product_get`	Get detailed product info

🛒 Cart Tools

Tool	Description
`cart_check_auth`	Check authentication status
`cart_get`	View cart contents
`cart_add`	Add item (requires confirmation)
`cart_add_many`	Bulk add multiple items
`cart_remove`	Remove item

🎟️ Coupon Tools

Tool	Description
`coupon_list`	List available coupons
`coupon_search`	Search coupons by keyword
`coupon_clip`	Clip a coupon
`coupon_clipped`	List your clipped coupons

🔐 Session Tools

Tool	Description
`session_status`	Check session health
`session_refresh`	Refresh/login session
`session_save_credentials`	Save credentials for auto-login
`session_clear`	Logout

📚 Documentation

🔧 Troubleshooting Guide - Solutions for common issues
🤝 Contributing - How to contribute
📝 Changelog - Version history
🔒 Security - Security policy

🛠️ Development

bash

# Clone repository
git clone https://github.com/mgwalkerjr95/texas-grocery-mcp
cd texas-grocery-mcp

# Install with dev dependencies
pip install -e ".[dev]"
playwright install chromium

# Run tests
pytest tests/ -v

# Linting & type checking
ruff check src/
mypy src/

🐳 Docker

bash

docker-compose up --build

🏗️ Architecture

Code

┌─────────────────────────────────────────────────────────────┐
│                    User's MCP Environment                    │
│                                                             │
│  ┌─────────────────────┐    ┌─────────────────────────────┐ │
│  │  🎭 Playwright MCP  │    │   🛒 Texas Grocery MCP      │ │
│  │  (Browser Auth)     │───▶│   (Grocery Logic)           │ │
│  └─────────────────────┘    └─────────────────────────────┘ │
│                                        │                     │
└────────────────────────────────────────┼─────────────────────┘
                                         │
                                         ▼
                                   🌐 HEB GraphQL API

📄 License

MIT © Michael Walker

Made with ❤️ in Texas 🤠

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Texas Grocery

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "texas-grocery": { "command": "npx", "args": ["-y", "texas-grocery"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/texas-grocery?style=directory)](https://allmcps.com/mcp/texas-grocery)

HTML Embed

<a href="https://allmcps.com/mcp/texas-grocery"><img src="https://allmcps.com/api/badge/texas-grocery?style=directory" alt="Texas Grocery on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

28Quality signal: Emerging · 28/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools12/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Texas Grocery →Install in Claude Desktop Install in Cursor Install in VS Code

Texas Grocery

MCP server for HEB grocery store integration - search products, manage carts, clip coupons, and more

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "texas-grocery": {
      "command": "npx",
      "args": [
        "-y",
        "texas-grocery"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

🛒 Texas Grocery MCP

🤖 Let AI do your grocery shopping! An MCP server that connects Claude to H-E-B grocery stores.

Search products, manage your cart, clip coupons, and more — all through natural conversation.

✨ Features

Feature	Description
🏪 Store Search	Find HEB stores by address or zip code
🔍 Product Search	Search products with pricing and availability
🛒 Cart Management	Add/remove items with human-in-the-loop confirmation
📋 Product Details	Ingredients, nutrition facts, allergens, warnings
🎟️ Digital Coupons	List, search, and clip coupons to save money
🔄 Auto Session Refresh	Handles bot detection automatically (~15 seconds)

📦 Installation

Quick Start

Terminal

pip install texas-grocery-mcp

Full Installation (Recommended) 🚀

Terminal

pip install texas-grocery-mcp[browser]
playwright install chromium

This enables fast auto-refresh (~15 seconds) using an embedded browser.

Prerequisites

For cart operations and session management, you'll also need Playwright MCP:

Terminal

npm install -g @anthropic-ai/mcp-playwright

⚙️ Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

config.json

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@anthropic-ai/mcp-playwright"]
    },
    "heb": {
      "command": "uvx",
      "args": ["texas-grocery-mcp"],
      "env": {
        "HEB_DEFAULT_STORE": "590"
      }
    }
  }
}

Environment Variables

Variable	Description	Default
`HEB_DEFAULT_STORE`	Default store ID	None
`REDIS_URL`	Redis cache URL	None (in-memory)
`LOG_LEVEL`	Logging level	INFO

🎯 Usage Examples

🏪 Finding a Store

Code

User: Find HEB stores near Austin, TX

Agent uses: store_search(address="Austin, TX", radius_miles=10)

🔍 Searching Products

Code

User: Search for organic milk

Agent uses: store_change(store_id="590")
Agent uses: product_search(query="organic milk")

📋 Getting Product Details

Code

User: What are the ingredients in H-E-B olive oil?

Agent uses: product_search(query="heb olive oil")
Agent uses: product_get(product_id="127074")
# Returns: ingredients, nutrition facts, warnings, dietary attributes

The product_get tool returns:

🥗 Ingredients - Full ingredient statement
📊 Nutrition Facts - Complete FDA panel
⚠️ Safety Warnings - Allergen info and precautions
🌿 Dietary Attributes - Gluten-free, organic, vegan, kosher, etc.
📍 Store Location - Aisle or section

🛒 Adding to Cart

Code

User: Add 2 gallons of milk to my cart

Agent uses: cart_add(product_id="123456", quantity=2)
# Returns preview for confirmation

Agent uses: cart_add(product_id="123456", quantity=2, confirm=true)
# ✅ Added to cart!

🎟️ Clipping Coupons

Code

User: Find coupons for cereal

Agent uses: coupon_search(query="cereal")
Agent uses: coupon_clip(coupon_id="ABC123", confirm=true)
# ✅ Coupon clipped!

🔐 Session Management

HEB uses bot detection that expires every ~11 minutes. This MCP handles it automatically!

⚡ Fast Auto-Refresh (Recommended)

With [browser] support installed:

Code

Agent uses: session_refresh()
# ✅ Completes in ~10-15 seconds

🔑 Auto-Login

Save your credentials once for automatic login:

Code

Agent uses: session_save_credentials(email="you@email.com", password="...")
# Credentials stored securely in system keyring
# Future session refreshes will auto-login!

🧰 Available Tools

🏪 Store Tools

Tool	Description
`store_search`	Find stores by address
`store_change`	Set preferred store
`store_get_default`	Get current default store

🔍 Product Tools

Tool	Description
`product_search`	Search products with pricing
`product_search_batch`	Search multiple products (up to 20)
`product_get`	Get detailed product info

🛒 Cart Tools

Tool	Description
`cart_check_auth`	Check authentication status
`cart_get`	View cart contents
`cart_add`	Add item (requires confirmation)
`cart_add_many`	Bulk add multiple items
`cart_remove`	Remove item

🎟️ Coupon Tools

Tool	Description
`coupon_list`	List available coupons
`coupon_search`	Search coupons by keyword
`coupon_clip`	Clip a coupon
`coupon_clipped`	List your clipped coupons

🔐 Session Tools

Tool	Description
`session_status`	Check session health
`session_refresh`	Refresh/login session
`session_save_credentials`	Save credentials for auto-login
`session_clear`	Logout

📚 Documentation

🔧 Troubleshooting Guide - Solutions for common issues
🤝 Contributing - How to contribute
📝 Changelog - Version history
🔒 Security - Security policy

🛠️ Development

bash

# Clone repository
git clone https://github.com/mgwalkerjr95/texas-grocery-mcp
cd texas-grocery-mcp

# Install with dev dependencies
pip install -e ".[dev]"
playwright install chromium

# Run tests
pytest tests/ -v

# Linting & type checking
ruff check src/
mypy src/

🐳 Docker

bash

docker-compose up --build

🏗️ Architecture

Code

┌─────────────────────────────────────────────────────────────┐
│                    User's MCP Environment                    │
│                                                             │
│  ┌─────────────────────┐    ┌─────────────────────────────┐ │
│  │  🎭 Playwright MCP  │    │   🛒 Texas Grocery MCP      │ │
│  │  (Browser Auth)     │───▶│   (Grocery Logic)           │ │
│  └─────────────────────┘    └─────────────────────────────┘ │
│                                        │                     │
└────────────────────────────────────────┼─────────────────────┘
                                         │
                                         ▼
                                   🌐 HEB GraphQL API

📄 License

Made with ❤️ in Texas 🤠

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Texas Grocery

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "texas-grocery": { "command": "npx", "args": ["-y", "texas-grocery"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/texas-grocery?style=directory)](https://allmcps.com/mcp/texas-grocery)

HTML Embed

<a href="https://allmcps.com/mcp/texas-grocery"><img src="https://allmcps.com/api/badge/texas-grocery?style=directory" alt="Texas Grocery on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

28Quality signal: Emerging · 28/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools12/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Texas Grocery →Install in Claude Desktop Install in Cursor Install in VS Code