io.github.markswendsen-code/instacart

@striderlabs/mcp-instacart

Order groceries via Instacart using AI agents

Part of Strider Labs — action execution for personal AI agents.

Get Started in 2 Minutes

For Claude Desktop Users

1. Add this to your Claude Desktop config:

{
  "mcpServers": {
    "instacart": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-instacart"]
    }
  }
}

1. Restart Claude.
2. Tell Claude: "Order my usual groceries for delivery tomorrow morning"

Your agent can now place orders. That's it.

Installation (NPM)

npm install @striderlabs/mcp-instacart

Or with npx directly:

npx @striderlabs/mcp-instacart

Features

• 🛒 Search for products by name or category
• 📦 Browse stores and product availability
• 🏪 Add to cart with quantities and special requests
• 💳 Place orders with delivery time selection
• 📍 Track orders with real-time status
• 🔐 Persistent sessions - stay logged in across restarts
• 🔄 Automatic MFA - handles multi-factor authentication
• 📱 Per-user credentials - encrypted session storage
• ⭐ Saved items - order your favorites faster

Tested & Compatible

Metrics

• Weekly downloads: 271 (Apr 10-17, 2026) — Top grocery connector (+330% growth)
• Status: ✅ Live in production
• Reliability: 85%+ task completion rate
• Discovery: npm, mcpservers.org, ClawHub, PulseMCP, Glama, LobeHub

Available Elsewhere

• npm: npmjs.com/@striderlabs/mcp-instacart
• Claude Plugins: Search "Strider Labs" in Claude
• mcpservers.org: Strider Labs Instacart
• Full Strider Labs: github.com/striderlabsdev/striderlabs

How It Works

For Agents

Your agent can use these capabilities:

// Search for products
products = search_products({
  query: "organic milk",
  location: "San Francisco, CA"
})

// Browse a store's offerings
store_products = get_store_products({
  store_id: "whole_foods_sf",
  category: "Dairy"
})

// Add to cart
add_to_cart({
  product_id: "organic_milk_gallon",
  quantity: 2,
  special_instructions: "Cold stock, please"
})

// Place an order
order = place_order({
  delivery_time: "tomorrow morning",
  delivery_address: "123 Main St, San Francisco, CA",
  special_instructions: "Ring the doorbell twice"
})

// Track delivery
status = track_order({ order_id: order.order_id })

Session Management

• Each user has encrypted, persistent credentials
• Automatic OAuth token refresh
• MFA handling (SMS/email)
• Sessions survive agent restarts

Reliability

• 85%+ task completion rate
• Automated UI change detection (connectors update when Instacart changes)
• Fallback paths for failures
• 24/7 monitoring + alerting

Authentication

The MCP server uses a persistent browser profile (~/.strider/instacart/browser-profile) so your login session survives server restarts automatically.

First-time login

1. Set INSTACART_HEADLESS=false in your MCP server config so the browser window is visible:

{
  "mcpServers": {
    "instacart": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-instacart"],
      "env": { "INSTACART_HEADLESS": "false" }
    }
  }
}

1. Restart Claude / your MCP client.
2. Ask Claude to run instacart_login — a real browser window will open.
3. Log in to Instacart inside that window.
4. Run instacart_status to confirm authentication.
5. Remove INSTACART_HEADLESS (or set it back to true) and restart — the saved profile keeps you logged in.

How login detection works

Authentication is verified by navigating to /account and confirming the page resolves without a redirect to /login or /authentication (positive detection). This is more reliable than checking for the absence of a "Log in" button.

Configuration

Environment Variables

# Show browser window (required for first-time login)
INSTACART_HEADLESS=false   # default: true (headless)

Self-Hosted

# Clone the repo
git clone https://github.com/striderlabsdev/mcp-instacart
cd mcp-instacart

# Install dependencies
npm install

# Start the server
npm start

# Your agent can now connect to localhost:3000

Architecture

How We Connect

This connector uses browser automation (Playwright) to interact with Instacart, because Instacart doesn't have a public API. Here's why that's safe and reliable:

• User-controlled: Your agent only accesses your own Instacart account
• Session-based: We store your login session securely, not your password
• Change-aware: We detect Instacart UI changes and alert immediately
• Fingerprinting: We use realistic browser profiles to avoid bot detection
• Rate-limited: We respect Instacart's infrastructure with appropriate delays

Security

• Credentials stored encrypted in your local .env or secure vault
• Sessions isolated per user
• No data sent to third parties
• MIT Licensed — audit the code yourself

Support

• 📖 Full Strider Labs Docs
• 🐛 Report Issues
• 💬 Discussions
• 🌐 Website
• 📧 Email

Contributing

We welcome contributions! Areas of interest:

• Bug reports and fixes
• Feature requests (new stores, categories, etc.)
• Performance improvements
• Documentation enhancements

See CONTRIBUTING.md for guidelines.

License

MIT — Free to use, modify, and distribute. See LICENSE for details.

Built by Strider Labs — Making AI agents actually useful.

GitHub | Website | Discord