Carrefour Drive

MCP server for Carrefour Drive — Search products, manage your cart, check delivery slots, and order groceries via AI assistants.

Built with Playwright (headless Chrome) since Carrefour doesn't provide a public API.

Features

• Login/Logout — Authenticate with your Carrefour account, session persisted via cookies
• Store selection — Find and select your Carrefour Drive by postal code
• Product search — Search products with prices, promotions, and availability
• Product details — Get nutrition facts, ingredients, allergens
• Cart management — Add, remove, update quantities
• Delivery slots — View available pickup slots and reserve one

Note: This MCP does NOT handle payment. You validate and pay manually on the Carrefour website.

Installation

npm install mcp-carrefour-drive

Or clone and build:

git clone https://github.com/maximeallanic/mcp-carrefour-drive.git
cd mcp-carrefour-drive
npm install
npx playwright install chromium
npm run build

Configuration

Environment variables

Variable	Description	Required
CARREFOUR_EMAIL	Your Carrefour account email	Yes (for login)
CARREFOUR_PASSWORD	Your Carrefour account password	Yes (for login)
CARREFOUR_DATA_DIR	Directory for cookies/session data	No (default: ~/.carrefour-mcp)

Claude Code / Claude Desktop

Add to your .mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "carrefour-drive": {
      "command": "npx",
      "args": ["-y", "mcp-carrefour-drive"],
      "env": {
        "CARREFOUR_EMAIL": "[email protected]",
        "CARREFOUR_PASSWORD": "your-password"
      }
    }
  }
}

Docker

Since this uses headless Chrome, you need to install Chromium in your Docker container:

RUN npx playwright install --with-deps chromium

Available Tools

Tool	Description
login	Login to Carrefour with email/password
check_login	Check if currently logged in
logout	Logout from Carrefour
select_store	Select a Carrefour Drive by postal code
search_products	Search for products
get_product_details	Get detailed product info (nutrition, ingredients)
add_to_cart	Add a product to your cart
remove_from_cart	Remove a product from your cart
update_cart_quantity	Update product quantity in cart
get_cart	View current cart contents and total
get_available_slots	List available pickup time slots
select_slot	Reserve a pickup slot

Example usage

> Search for "lait demi-écrémé"
> Add the first result to my cart, quantity 2
> What's in my cart?
> Show me available pickup slots for tomorrow

Limitations

• Carrefour's website may change at any time, breaking selectors
• Rate limiting may apply — the server adds reasonable delays between actions
• No payment automation (by design)
• Requires a headless Chrome environment (not compatible with minimal Docker images)

License

MIT