English Français العربية

io.github.mgwalkerjr95/texas-grocery

Registre officiel Recherche et web

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package texas-grocery-mcp
Claude Code 
claude mcp add texas-grocery -- uvx texas-grocery-mcp==0.1.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "texas-grocery": {
            "command": "uvx",
            "args": [
                "texas-grocery-mcp==0.1.3"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. 🛒 Texas Grocery MCP
  2. ✨ Features
  3. 📦 Installation
  4. ⚙️ Configuration
  5. 🎯 Usage Examples
  6. 🔐 Session Management
  7. 🧰 Available Tools
  8. 📚 Documentation
  9. 🛠️ Development
  10. 🏗️ Architecture
  11. 📄 License

🛒 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

FeatureDescription
🏪 Store SearchFind HEB stores by address or zip code
🔍 Product SearchSearch products with pricing and availability
🛒 Cart ManagementAdd/remove items with human-in-the-loop confirmation
📋 Product DetailsIngredients, nutrition facts, allergens, warnings
🎟️ Digital CouponsList, search, and clip coupons to save money
🔄 Auto Session RefreshHandles bot detection automatically (~15 seconds)

📦 Installation

Quick Start
pip install texas-grocery-mcp
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:

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

⚙️ Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_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
VariableDescriptionDefault
HEB_DEFAULT_STOREDefault store IDNone
REDIS_URLRedis cache URLNone (in-memory)
LOG_LEVELLogging levelINFO

🎯 Usage Examples

🏪 Finding a Store
User: Find HEB stores near Austin, TX

Agent uses: store_search(address="Austin, TX", radius_miles=10)
🔍 Searching Products
User: Search for organic milk

Agent uses: store_change(store_id="590")
Agent uses: product_search(query="organic milk")
📋 Getting Product Details
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
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
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!

With [browser] support installed:

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

Save your credentials once for automatic login:

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
ToolDescription
store_searchFind stores by address
store_changeSet preferred store
store_get_defaultGet current default store
🔍 Product Tools
ToolDescription
product_searchSearch products with pricing
product_search_batchSearch multiple products (up to 20)
product_getGet detailed product info
🛒 Cart Tools
ToolDescription
cart_check_authCheck authentication status
cart_getView cart contents
cart_addAdd item (requires confirmation)
cart_add_manyBulk add multiple items
cart_removeRemove item
🎟️ Coupon Tools
ToolDescription
coupon_listList available coupons
coupon_searchSearch coupons by keyword
coupon_clipClip a coupon
coupon_clippedList your clipped coupons
🔐 Session Tools
ToolDescription
session_statusCheck session health
session_refreshRefresh/login session
session_save_credentialsSave credentials for auto-login
session_clearLogout

📚 Documentation

🛠️ Development

# 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
docker-compose up --build

🏗️ Architecture

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

📄 License

MIT © Michael Walker

Made with ❤️ in Texas 🤠

Questions fréquentes

Qu'est-ce que io.github.mgwalkerjr95/texas-grocery ?

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

Comment installer io.github.mgwalkerjr95/texas-grocery ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add texas-grocery -- uvx texas-grocery-mcp==0.1.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.mgwalkerjr95/texas-grocery ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.mgwalkerjr95/texas-grocery est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.mgwalkerjr95/texas-grocery ?

Il est publié par mgwalkerjr95. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.