@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/sdkover stdio transport
Author
Strider Labs <[email protected]>
