Costco MCP Server

@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

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

Shopping

Delivery & Checkout

Orders

Membership & Locations

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):

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