@striderlabs/mcp-nordstrom
v1.0.0
Published
Model Context Protocol connector for Nordstrom retail
Maintainers
Readme
@striderlabs/mcp-nordstrom
Model Context Protocol (MCP) connector for Nordstrom retail. Browse products, manage your shopping bag, wishlist, and orders through any MCP-compatible AI client.
Features
| Tool | Description | Auth Required |
|---|---|---|
| search_products | Search merchandise by keyword, category, or brand | No |
| get_product | Get full product details, sizes, and images | No |
| add_to_bag | Add an item to your shopping bag | Yes |
| get_bag | View shopping bag contents and totals | Yes |
| remove_from_bag | Remove an item from bag | Yes |
| get_wishlist | View saved/favorited items | Yes |
| add_to_wishlist | Save an item to your wishlist | Yes |
| check_inventory | Check store availability near a ZIP code | No |
| get_orders | View order history | Yes |
| track_order | Track a shipment | Yes |
Installation
npm install @striderlabs/mcp-nordstromAuthentication
Authenticated tools (bag, wishlist, orders) require Nordstrom account credentials. Set them as environment variables:
export NORDSTROM_EMAIL="[email protected]"
export NORDSTROM_PASSWORD="yourpassword"Alternatively, save credentials to ~/.nordstrom-mcp/credentials.json:
{
"email": "[email protected]",
"password": "yourpassword"
}The file is stored with 600 permissions (owner read/write only).
Usage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"nordstrom": {
"command": "npx",
"args": ["-y", "@striderlabs/mcp-nordstrom"],
"env": {
"NORDSTROM_EMAIL": "[email protected]",
"NORDSTROM_PASSWORD": "yourpassword"
}
}
}
}Tool Reference
search_products
{
"query": "black ankle boots",
"category": "women",
"brand": "Sam Edelman"
}get_product
{
"product_id": "7654321"
}product_id can be a Nordstrom numeric style ID or a full product URL.
add_to_bag
{
"product_id": "7654321",
"sku_id": "sku-9876",
"quantity": 1
}get_bag
No parameters required.
remove_from_bag
{
"item_id": "bag-item-id-from-get_bag"
}get_wishlist
No parameters required.
add_to_wishlist
{
"product_id": "7654321"
}check_inventory
{
"product_id": "7654321",
"size": "M",
"zip": "98101"
}get_orders
{
"limit": 5
}track_order
{
"order_number": "12345678"
}Development
# Install dependencies
npm install
# Build
npm run build
# Run in dev mode
npm run dev
# Pack for distribution
npm packNotes
- Uses Playwright for browser automation against nordstrom.com.
- Stealth mode enabled to reduce bot detection.
- Some actions (add to bag, wishlist) may be blocked if Nordstrom adds additional CAPTCHA challenges.
- This connector is for personal use only; respect Nordstrom's Terms of Service.
