Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sephora MCP ServerFind top-rated vitamin C serums for oily skin"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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 |
| Search for beauty products by keyword, category, and sort order |
| Get full product details, variants (shades/sizes), and reviews |
| Add a product to the shopping basket |
| View basket contents, quantities, and totals |
| Complete purchase with shipping and payment details |
| 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-sephoraMCP 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: "you@email.com", 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 <hello@striderlabs.ai>