Texas Grocery

You can run this MCP server to connect Claude with H-E-B grocery data, enabling store searches, product lookups, cart operations, coupon clipping, and more through natural conversation. This setup supports automatic session handling and browser-assisted actions for faster interactions with minimal manual work.

How to use

You run an MCP client that talks to the Texas Grocery MCP server. Start the server configurations, then point your MCP client to the available MCP endpoints. Use high-level actions like searching for stores, looking up products with prices and availability, adding items to your cart with confirmation, viewing product details, and clipping coupons. The server handles bot-detection and session maintenance so you can focus on your shopping conversation.

How to install

Prerequisites you need before installing include Python and, if you want browser-accelerated features, Playwright. Follow these steps to get everything running.

pip install texas-grocery-mcp

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

This enables fast auto-refresh using an embedded browser.

For cart operations and session management, install Playwright MCP globally:

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

## Configuration

Configure your Claude desktop to recognize the Texas Grocery MCP servers and enable a default store for H-E-B.

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

## Environment variables

The following environment variables are available for configuring behavior and defaults.

HEB_DEFAULT_STORE: Default store ID REDIS_URL: Redis cache URL LOG_LEVEL: Logging level

## Usage examples

Typical conversations map to tool actions under the hood. For example, you can search for a store, pick a store, search for products, view details, add items to the cart, and clip coupons. The system handles session refreshes automatically when you have browser support installed.

## Session management

The MCP automatically handles bot-detection and session refreshes. With browser support installed, you can refresh sessions quickly to keep your interaction seamless.

## Available tools and workflows

The server exposes a set of tools to perform common shopping tasks. Use these endpoints or corresponding conversational intents to perform actions like searching stores, selecting a store, browsing products, retrieving product details, managing the cart, and clipping coupons.

## Development notes

If you plan to contribute or run the server locally in development, you can install dependencies, run tests, and start the local environment following the standard workflow described in the project setup.

## Available tools

### store\_search

Find stores by address or zip code to locate H-E-B locations.

### store\_change

Set the preferred store for subsequent product queries.

### store\_get\_default

Retrieve the current default store selection.

### product\_search

Search products with pricing and availability information.

### product\_search\_batch

Search multiple products in a single call (up to 20).

### product\_get

Get detailed product information including ingredients, nutrition facts, and warnings.

### cart\_check\_auth

Check authentication status for cart operations.

### cart\_get

View current cart contents.

### cart\_add

Add an item to the cart, with optional confirmation.

### cart\_add\_many

Add multiple items to the cart in one operation.

### cart\_remove

Remove an item from the cart.

### coupon\_list

List available coupons.

### coupon\_search

Search coupons by keywords.

### coupon\_clip

Clip a coupon to use at checkout.

### coupon\_clipped

List your clipped coupons.

### session\_status

Check current session health.

### session\_refresh

Refresh or reinitialize the session.

### session\_save\_credentials

Save user credentials for auto-login.

### session\_clear

Logout and clear the session data.