How do I use mcp-costco?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-costco Search for Kirkland olive oil and add two to my cart" 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.

mcp-costco

by markswendsen-code

Overview Schema Source Related Servers Discussions Admin

JavaScript

Local

@striderlabs/mcp-costco

MCP server connector for Costco — search products, manage cart, check membership, find warehouses, and place orders via browser automation.

Features

Search Products — Search Costco.com by keyword, category, or brand with price filters
Product Details — Get full product info, price, availability, and item number
Cart Management — Add items, view cart, update quantities, remove items
Delivery Options — Check home delivery and warehouse pickup availability
Checkout — Preview and place orders (with confirmation step)
Order History — View past orders with status
Order Tracking — Track shipment status and estimated delivery
Membership — Check membership type, number, and renewal date
Warehouse Locations — Find nearby Costco warehouses by ZIP or city
Warehouse Stock — Check in-store availability at specific locations

Related MCP server: MCP Shop Server

Requirements

Node.js 18+
A Costco membership account
Playwright browsers installed

Installation

npx playwright install chromium

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "costco": {
      "command": "npx",
      "args": ["@striderlabs/mcp-costco"]
    }
  }
}

Tools

Authentication

Tool	Description
`status`	Check authentication status and session info
`login`	Authenticate with email and password
`logout`	Clear session and stored cookies

Shopping

Tool	Description
`search_products`	Search by name, category, or brand
`get_product_details`	Get full product info, price, availability
`add_to_cart`	Add item to cart by URL or item number
`view_cart`	View cart contents and totals
`update_cart`	Change quantities or remove items (qty=0 removes)

Delivery & Checkout

Tool	Description
`get_delivery_options`	Check delivery/pickup availability for a ZIP
`select_delivery`	Choose home delivery or warehouse pickup
`checkout`	Preview (confirm=false) or place order (confirm=true)

Orders

Tool	Description
`get_orders`	View order history
`track_order`	Track delivery status by order number

Membership & Locations

Tool	Description
`get_membership`	Check membership type, number, and renewal date
`get_warehouse_locations`	Find nearby warehouses by ZIP or city
`check_warehouse_stock`	Check in-warehouse availability

Example Usage

# Login
login(email="you@example.com", password="yourpassword")

# Search for items
search_products(query="kirkland olive oil", limit=5)

# Get product details
get_product_details(item_number="1234567")

# Add to cart
add_to_cart(item_number="1234567", quantity=2)

# Preview checkout
checkout(confirm=false)

# Place order
checkout(confirm=true)

# Check membership
get_membership()

# Find nearby warehouses
get_warehouse_locations(zip_code="94105", limit=3)

Environment Variables

Credentials can also be passed via environment variables (used as defaults if login tool is not called):

Variable	Description
`COSTCO_EMAIL`	Costco account email
`COSTCO_PASSWORD`	Costco account password

Session Persistence

Sessions are stored in ~/.striderlabs/costco/ and persist across runs. You only need to log in once per machine.

Headless Mode

By default, the browser runs headless. To debug, pass headless=false to the login tool to see the browser window.

Author

Strider Labs — Building AI agent infrastructure.

License

MIT

Available Tools

16 tools

add_to_cartC

Add a Costco product to the cart

Name	Required	Description
`url`	No	Costco product URL
`item_number`	No	Costco item number
`quantity`	No	Quantity to add (default: 1)

checkoutA

Preview or complete a Costco order. Use confirm=false to preview first.

Name	Required	Description	Default
`confirm`	No	Set true to actually place the order. Default false (preview only).

check_warehouse_stockB

Check in-warehouse availability of a product at a specific Costco location

Name	Required	Description
`item_number`	No	Costco item number
`url`	No	Product URL (alternative to item_number)
`zip_code`	No	ZIP code to find nearby warehouses

get_delivery_optionsB

Check delivery and warehouse pickup availability for cart items or a specific product

Name	Required	Description	Default
`zip_code`	Yes	ZIP code to check delivery options
`item_number`	No	Costco item number to check availability for (optional, checks cart if omitted)

get_membershipB

Check Costco membership status, type, and renewal date

Name	Required	Description	Default
No parameters

get_ordersC

View Costco order history

Name	Required	Description	Default
`limit`	No	Number of recent orders to return (default: 10)

get_product_detailsC

Get detailed product information including price, description, and availability

Name	Required	Description	Default
`url`	No	Full Costco product URL (e.g., https://www.costco.com/...product.html)
`item_number`	No	Costco item number (alternative to URL)

get_warehouse_locationsC

Find nearby Costco warehouses by ZIP code or city

Name	Required	Description
`zip_code`	No	ZIP code to search near
`city`	No	City name to search near (alternative to zip_code)
`state`	No	State abbreviation (e.g., CA, WA)
`limit`	No	Maximum number of warehouses to return (default: 5)

loginB

Authenticate with Costco account using email and password via browser automation

Name	Required	Description
`email`	Yes	Costco account email
`password`	Yes	Costco account password
`headless`	No	Run browser in headless mode (default: true). Set false to see browser window.

logoutA

Clear Costco session and stored cookies

Name	Required	Description	Default
No parameters

search_productsC

Search Costco products by name, category, or brand

Name	Required	Description
`query`	Yes	Search term (product name, brand, category)
`category`	No	Category filter (e.g., 'electronics', 'grocery', 'furniture')
`min_price`	No	Minimum price filter
`max_price`	No	Maximum price filter
`sort_by`	No	Sort order (default: relevance)
`limit`	No	Maximum number of results (default: 10, max: 24)

select_deliveryC

Choose delivery method — home delivery or warehouse pickup

Name	Required	Description
`method`	Yes	Delivery method to select
`warehouse_id`	No	Warehouse ID for pickup (required if method is warehouse_pickup)
`zip_code`	No	ZIP code for delivery address lookup

statusB

Check Costco authentication status and session info

Name	Required	Description	Default
No parameters

track_orderC

Track a Costco order delivery status

Name	Required	Description	Default
`order_number`	Yes	Costco order number

update_cartB

Update item quantities or remove items from the Costco cart

Name	Required	Description	Default
`item_number`	Yes	Costco item number of the product to update
`quantity`	Yes	New quantity. Set to 0 to remove the item.

view_cartB

View current Costco cart contents and totals

Name	Required	Description	Default
No parameters

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

16 tool updatesv0.1.0Mar 11, 2026
- First observedadd_to_cart
- First observedcheck_warehouse_stock
- First observedcheckout
- First observedget_delivery_options
- First observedget_membership
- First observedget_orders
- First observedget_product_details
- First observedget_warehouse_locations
- First observedlogin
- First observedlogout
- First observedsearch_products
- First observedselect_delivery
- First observedstatus
- First observedtrack_order
- First observedupdate_cart
- First observedview_cart

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored 2026-04-13 23:55 across 16 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no significant overlap. For example, 'add_to_cart' and 'update_cart' handle different cart operations, while 'check_warehouse_stock' and 'get_delivery_options' address separate availability concerns. The descriptions reinforce these distinctions, making tool selection straightforward for an agent.

Naming Consistency5/5

All tools follow a consistent verb_noun naming pattern, such as 'add_to_cart', 'get_product_details', and 'track_order'. This uniformity enhances readability and predictability across the set, with no deviations in style or convention.

Tool Count5/5

With 16 tools, the server is well-scoped for a Costco e-commerce domain, covering authentication, product search, cart management, order processing, and membership functions. Each tool serves a specific role, avoiding bloat while providing comprehensive coverage for typical shopping workflows.

Completeness5/5

The toolset offers complete coverage for the Costco shopping domain, including CRUD operations for cart items, order lifecycle from checkout to tracking, product discovery, and account management. No obvious gaps exist; agents can perform end-to-end tasks like searching, adding to cart, checking out, and tracking orders seamlessly.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Jockey Delivery — Same-Day Local & Nationwide AI CommerceA
io.github.jennipro-engineering
Search live store shelves, verify delivery windows, and run instant AI agent checkouts.
E-commerce & Retail Payments & Billing
51
https://delivery.jockeyvc.com/mcp
agent-web-actions
com.trycloudflare.plates-spread-materials-optimum
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Browser Automation Agent Orchestration
2
https://plates-spread-materials-optimum.trycloudflare.com
agent-web-actions
com.trycloudflare.clients-involving-billion-headers
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Browser Automation Web Scraping
2
https://clients-involving-billion-headers.trycloudflare.com:5001
Reduck
ai.reduck
Automate any website: discover, run and create browser scripts that work behind logins.
Browser Automation Web Scraping
1
https://mcp.reduck.ai/mcp

Related MCP Servers

Woolworths MCP Server
Browser Automation E-commerce & Retail App Automation
elijah-g
A
license
A
quality
D
maintenance
Enables interaction with Woolworths Australia's online shopping platform through browser automation and API integration. Supports product search, browsing specials, managing shopping cart, and accessing product details through natural language.
Updated 8 months ago (2026-03-02 01:56 UTC)
8
12
17
GPL 3.0
MCP Shop Server
E-commerce & Retail Browser Automation Web Scraping
johan-perso
A
license
Not graded
quality
D
maintenance
Enables AI models to find the best online deals by browsing and interacting with multiple shopping platforms like Amazon and eBay across various regions. It uses Playwright to automate searches and retrieve product information from compatible e-commerce and deal-tracking websites.
Updated a year ago (2025-07-28 21:30 UTC)
11 npm
3
MIT
Instacart MCP Server
Browser Automation E-commerce & Retail App Automation
markswendsen-code
A
license
A
quality
D
maintenance
Enables AI agents to search for products, manage shopping carts, and place grocery orders on Instacart using browser automation. It includes comprehensive tools for store discovery, product searching, and secure checkout with explicit user confirmation.
Updated 5 months ago (2026-06-11 00:09 UTC)
11
101 npm
11
MIT
Sephora MCP Server
E-commerce & Retail Browser Automation
markswendsen-code
A
license
A
quality
D
maintenance
Enables users to search for beauty products, manage shopping baskets, and complete purchases on Sephora via an AI assistant. It also provides functionality to check Beauty Insider reward points and tier status using browser automation.
Updated 5 months ago (2026-06-17 13:45 UTC)
6
7 npm
MIT