@striderlabs/mcp-sephora

MCP connector for Sephora beauty retail. Search products, manage your basket, complete purchases, and check Beauty Insider rewards — all from an AI assistant.

Tools

| Tool | Description | |------|-------------| | sephora_search_products | Search for beauty products by keyword, category, and sort order | | sephora_get_product | Get full product details, variants (shades/sizes), and reviews | | sephora_add_to_basket | Add a product to the shopping basket | | sephora_view_basket | View basket contents, quantities, and totals | | sephora_checkout | Complete purchase with shipping and payment details | | sephora_get_rewards | View Beauty Insider points, tier, and available rewards |

Setup

# Install Playwright browser (one-time)
npx playwright install chromium

# Run the MCP server
npx @striderlabs/mcp-sephora

MCP Configuration

Add to your MCP client configuration:

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

Usage Examples

Search for products

sephora_search_products({ query: "vitamin C serum", category: "skincare", max_results: 5 })

Get product details

sephora_get_product({ product_url: "https://www.sephora.com/product/...", include_reviews: true })

Add to basket

sephora_add_to_basket({ product_url: "https://www.sephora.com/product/...", quantity: 1 })

Checkout (dry run)

sephora_checkout({ email: "...", first_name: "...", ..., dry_run: true })

View rewards

sephora_get_rewards({ email: "[email protected]", password: "yourpassword" })

Technical Details

• TypeScript with strict mode
• Playwright headless Chromium for browser automation
• Session management — single shared browser context with 30-minute timeout
• MCP SDK @modelcontextprotocol/sdk over stdio transport

Author

Strider Labs <[email protected]>