Texas Grocery MCP
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Texas Grocery MCPsearch for organic milk"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🛒 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
pip install texas-grocery-mcpFull Installation (Recommended) 🚀
pip install texas-grocery-mcp[browser]
playwright install chromiumThis 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
Variable | Description | Default |
| Default store ID | None |
| Redis cache URL | None (in-memory) |
| Logging level | INFO |
🎯 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 attributesThe 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!
⚡ Fast Auto-Refresh (Recommended)
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
Tool | Description |
| Find stores by address |
| Set preferred store |
| Get current default store |
🔍 Product Tools
Tool | Description |
| Search products with pricing |
| Search multiple products (up to 20) |
| Get detailed product info |
🛒 Cart Tools
Tool | Description |
| Check authentication status |
| View cart contents |
| Add item (requires confirmation) |
| Bulk add multiple items |
| Remove item |
🎟️ Coupon Tools
Tool | Description |
| List available coupons |
| Search coupons by keyword |
| Clip a coupon |
| List your clipped coupons |
🔐 Session Tools
Tool | Description |
| Check session health |
| Refresh/login session |
| Save credentials for auto-login |
| Logout |
📚 Documentation
🔧 Troubleshooting Guide - Solutions for common issues
🤝 Contributing - How to contribute
📝 Changelog - Version history
🔒 Security - Security policy
🛠️ 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
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/mgwalkerjr95/texas-grocery-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server