@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

| 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="[email protected]", 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