The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Walmart listing page.
MCP server connector for Walmart retail shopping — search products, manage cart, and track orders via browser automation.
This connector enables autonomous shopping on behalf of your human. Agents can:
Example agent workflow:
User: "I need groceries for the week. My budget is $100, and I need vegetarian options."
Agent executes:
set_address → Get local store availabilitysearch → "organic vegetables", max_price: 50search → "rice, pasta, beans" with filtersget_product → Check nutrition and price for eachadd_to_cart → Build optimized cart under $100checkout → Review total ($94.32) and return summary to userAll in one seamless agent turn.
This package provides a Model Context Protocol (MCP) server that enables AI agents to interact with Walmart.com through Playwright browser automation with stealth features to avoid bot detection.
Or install globally:
Add to your MCP client configuration:
statusCheck Walmart authentication status and session info.
No parameters required.
loginAuthenticate with your Walmart account using email and password via browser automation.
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | Yes | Walmart account email |
password | string | Yes | Walmart account password |
headless | boolean | No | Run browser headless (default: true). Set false to see the browser window. |
logoutClear Walmart session and stored cookies.
No parameters required.
set_addressSet delivery or pickup address for Walmart. Affects product availability and pricing.
| Parameter | Type | Required | Description |
|---|---|---|---|
zip_code | string | No* | ZIP code (e.g., "90210") |
address | string | No* | Full address (e.g., "123 Main St, Chicago, IL 60601") |
*At least one of zip_code or address is required.
searchSearch Walmart products by query with optional filters.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search term |
min_price | number | No | Minimum price filter |
max_price | number | No | Maximum price filter |
sort_by | string | No | Sort order: relevance, price_low, price_high, best_seller, rating_high |
limit | number | No | Max results (default: 10, max: 24) |
get_productGet detailed product information including price, description, and availability.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | No* | Full Walmart product URL |
item_id | string | No* | Walmart product item ID |
*At least one of url or item_id is required.
add_to_cartAdd a product to the Walmart cart.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | No* | Walmart product URL |
item_id | string | No* | Walmart product item ID |
quantity | number | No | Quantity to add (default: 1) |
*At least one of url or item_id is required.
view_cartView current Walmart cart contents and totals.
No parameters required.
update_cartUpdate the quantity of an item in the Walmart cart.
| Parameter | Type | Required | Description |
|---|---|---|---|
quantity | number | Yes | New quantity (must be >= 1) |
item_id | string | No* | Walmart product item ID |
product_name | string | No* | Partial product name to match |
*At least one of item_id or product_name is required.
remove_from_cartRemove a specific item from the Walmart cart.
| Parameter | Type | Required | Description |
|---|---|---|---|
item_id | string | No* | Walmart product item ID |
product_name | string | No* | Partial product name to match |
*At least one of item_id or product_name is required.
checkoutPreview checkout summary for the Walmart cart. Returns order details without placing the order.
No parameters required.
Note: This tool intentionally does not place the order. It returns the order summary (items, subtotal, tax, total) so you can review before proceeding manually.
get_ordersGet Walmart order history.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of recent orders to return (default: 10) |
Cookies and auth info are stored in ~/.striderlabs/walmart/ and persist across sessions. Once logged in, subsequent tool calls reuse the existing session without re-authenticating.
~/.striderlabs/walmart/cookies.json and ~/.striderlabs/walmart/auth.jsonMIT — Strider Labs