@striderlabs/mcp-gopuff

MCP server for GoPuff — let AI agents search products, manage cart, and place quick delivery convenience store orders.

Built by Strider Labs.

Features

• Search GoPuff products by keyword
• Get detailed product information
• Browse product categories
• Add items to cart
• View cart contents and totals
• Get delivery estimates by zip code
• Check order status
• Place orders (with explicit confirmation)

Installation

npm install -g @striderlabs/mcp-gopuff

Or use directly with npx:

npx @striderlabs/mcp-gopuff

Usage with Claude Desktop

Add to your claude_desktop_config.json:

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

Tools

| Tool | Description | |------|-------------| | gopuff_status | Check login status and session info | | gopuff_login | Log in with email and password | | gopuff_logout | Log out and clear session | | search_items | Search for products by keyword | | get_product_details | Get details for a specific product URL | | get_categories | List available product categories | | add_to_cart | Add a product to cart | | view_cart | View current cart contents | | checkout | Place an order (requires confirm_placement: true) | | get_order_status | Check status of recent or specific orders | | get_delivery_estimate | Get delivery ETA for a zip code |

Authentication

Session cookies are persisted at ~/.strider/gopuff/ so you only need to log in once per session.

Requirements

• Node.js 18+
• Playwright (installed automatically as a dependency)
• A GoPuff account
• Service availability in your area

Build from Source

git clone https://github.com/striderlabs/mcp-gopuff
cd mcp-gopuff
npm install
npm run build

License

MIT