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) |
Related MCP server: Shopping MCP Server (Amazon + Target)
📦 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
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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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