# mcp-carrefour-drive

MCP server for [Carrefour Drive](https://www.carrefour.fr) — Search products, manage your cart, check delivery slots, and order groceries via AI assistants.

Built with [Playwright](https://playwright.dev/) (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

```bash
npm install mcp-carrefour-drive
```

Or clone and build:

```bash
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`:

```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:

```dockerfile
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