mcp-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.

Related MCP server: mcp-leclerc-drive

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

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": "your-email@example.com",
        "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

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