markswendsen-code avatar

Instacart

markswendsen-code/mcp-instacart

This is browser automation for Instacart wrapped in an MCP interface. It gives your agent tools to search products, browse stores, add items to cart, place orders with delivery windows, and track shipments. Works by running a persistent Playwright session that keeps you logged in across restarts. You set INSTACART_HEADLESS to false once, log in manually, then the server handles everything headless from there. Built by Strider Labs as part of their action execution toolkit. Useful if you want Claude or another LLM to handle recurring grocery orders or one-off shopping requests without opening the Instacart app yourself.

GitHub stars
1
tools
3
auth
Secret needed
transport
STDIO
env vars
2
last updated
Apr 17, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

INSTACART_CREATE_RECIPE_PAGECreate a Recipe Page on Instacart + return shareable URL. Attempts prod first then falls back to dev; errors from prod bubble up if both fail.5 params

Create a Recipe Page on Instacart + return shareable URL. Attempts prod first then falls back to dev; errors from prod bubble up if both fail.

Parameters* required
expires_ininteger
Optional days until link expiration (1-365)
image_urlstring
Optional image for the recipe
ingredientsarray
Recipe ingredients
instructionsarray
Optional list of instructions/steps
titlestring
Title of the recipe
INSTACART_CREATE_SHOPPING_LIST_PAGECreate a Shopping List Page on Instacart + return shareable URL. Attempts prod first then falls back to dev; errors from prod bubble up if both fail.5 params

Create a Shopping List Page on Instacart + return shareable URL. Attempts prod first then falls back to dev; errors from prod bubble up if both fail.

Parameters* required
expires_ininteger
Optional days until link expiration (1-365)
image_urlstring
Optional image for the page
instructionsstring
Optional instructions/context shown on the page
line_itemsarray
List of items to include on the shopping list
titlestring
Optional title for the generated shopping list page
INSTACART_GET_NEARBY_RETAILERSGet nearby retailers by postal_code + country_code. Attempts prod first then falls back to dev; errors from prod bubble up if both fail.2 params

Get nearby retailers by postal_code + country_code. Attempts prod first then falls back to dev; errors from prod bubble up if both fail.

Parameters* required
country_codestring
Country code (US or CA)
postal_codestring
Postal code

Sponsors

Configuration

INSTACART_EMAIL*

Instacart email for authentication

INSTACART_PASSWORD*secret

Instacart account password

Readme

@striderlabs/mcp-instacart

Order groceries via Instacart using AI agents

npm MCP Registry Claude Desktop License: MIT

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


View the full README on GitHub

Details

Repository
github.com/markswendsen-code/mcp-instacart
Package
@striderlabs/mcp-instacart
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from markswendsen-code