Sephora Server

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]>