# instacart

An MCP server that lets an AI agent shop on Instacart: search products, fill a cart, place an order and follow the delivery.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: markswendsen-code
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/markswendsen-code/mcp-instacart
- Updated: 2026-06-11
- HTML: https://affpapa.org/en/nevibecode/mcp/instacart

## What it does

The server reaches Instacart through browser automation built on Playwright, since the service has no public API. An agent can search for products by name or category, check what a given store carries, add items with quantities and special requests, schedule a delivery and track the order afterwards.

Your login lives in a persistent browser profile at `~/.strider/instacart/browser-profile`, so it survives a server restart. The first sign-in needs `INSTACART_HEADLESS=false` in the config: a real browser window opens, you log in there, then confirm with `instacart_status`. Leave it headless and there is no window to log into.

Credentials go in through `INSTACART_EMAIL` and `INSTACART_PASSWORD`. Node.js 18 or newer is required. The README lists MCP SDK ^1.0.0 and Claude Desktop as tested, and the server itself runs with `npx -y @striderlabs/mcp-instacart`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `INSTACART_EMAIL`, `INSTACART_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add instacart -e INSTACART_EMAIL=<INSTACART_EMAIL> -e INSTACART_PASSWORD=<INSTACART_PASSWORD> -- npx -y @striderlabs/mcp-instacart
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add instacart --env INSTACART_EMAIL=<INSTACART_EMAIL> --env INSTACART_PASSWORD=<INSTACART_PASSWORD> -- npx -y @striderlabs/mcp-instacart
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "instacart": {
            "command": "npx",
            "args": [
                "-y",
                "@striderlabs/mcp-instacart"
            ],
            "env": {
                "INSTACART_EMAIL": "<INSTACART_EMAIL>",
                "INSTACART_PASSWORD": "<INSTACART_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "instacart": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@striderlabs/mcp-instacart"
            ],
            "env": {
                "INSTACART_EMAIL": "<INSTACART_EMAIL>",
                "INSTACART_PASSWORD": "<INSTACART_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e INSTACART_EMAIL=<INSTACART_EMAIL> -e INSTACART_PASSWORD=<INSTACART_PASSWORD> instacart npx -y @striderlabs/mcp-instacart
```
Replace <…> with your own values

## When to use it
- search products by name or category
- check what a specific store stocks
- build a cart with quantities and special requests
- schedule a delivery time when placing an order
- track the status of an order already placed

## Example prompts
- Find organic milk at stores in San Francisco
- Add two gallons of milk to the cart and ask for cold stock
- Place a delivery order for tomorrow morning at my saved address

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md