Shufersal MCP Server

Shufersal MCP Server is an MCP server that connects large language model clients to the Shufersal online shopping platform via Puppeteer browser automation. Designed for shoppers, home cooks, and automated meal planners, it enables AI assistants to search product catalogs, parse recipe URLs into shopping lists, and manage items directly within the Shufersal cart. Users log into Shufersal to retrieve personalized search results sorted by past purchase history. The server exposes specific tools for navigating the website, reading external recipes into structured markdown ingredients, searching for exact grocery items, and inserting specified quantities and comments into the cart. Additionally, developers and power users can access automated browser console logs via dedicated MCP resources for troubleshooting. Session data is stored locally across runs, allowing persistent authenticated sessions while interacting with the Israeli supermarket chain's web store.

Category: Browser & Web Automation

Tags: automation, e-commerce, retail, shopping, shufersal

Visit Shufersal MCP Server

How to install and configure Shufersal MCP Server

1. Clone the repository from https://github.com/matipojo/shufersal-mcp and navigate to the project directory. 2. Build the project using npm run build. 3. Add the server configuration to your Claude Desktop configuration file: json { "mcpServers": { "shufersal": { "command": "node", "args": ["<path/to/shufersal-mcp>/dist/index.js"] } } } 4. If using Windows, update the command value to specify the path to Node (<path/to/node>). 5. Optionally pass --user-data-dir=<path/to/custom/user/data> within args to store browser session data in a custom folder. 6. Restart Claude Desktop and log in to Shufersal via the opened browser during initial use.

What you can do with Shufersal MCP Server

• Converting online recipe links into structured ingredient tables and adding the corresponding groceries to your Shufersal cart. * Searching the Shufersal product inventory using past purchase history to surface preferred pantry staples and dairy items. * Automating weekly grocery replenishment by passing predefined shopping lists directly to the cart management tool. * Adding items to the digital cart with specific quantities, selling methods, and custom delivery instructions or comments. * Monitoring Puppeteer automation logs through the MCP console resource to debug checkout and navigation issues.

Key facts

• https://github.com/matipojo/shufersal-mcp
• Browser & Web Automation, CRM, ERP & E-commerce
• automation, e-commerce, retail, shopping, shufersal

Part of MCP Servers

How do I install Shufersal MCP Server?

You clone the repository from GitHub, compile the TypeScript code using npm run build, and register the node command with the path to dist/index.js in your Claude Desktop configuration file. Session data persists in a local directory.

What can Shufersal MCP Server do?

It provides automated tools to open the Shufersal website, parse external recipe URLs into structured markdown shopping lists, search product catalogs with personalized history sorting, and append items directly to your Shufersal cart with custom quantities.

Which MCP clients work with Shufersal MCP Server?

The server works with any standard Model Context Protocol client that supports local stdio transport, such as Claude Desktop. The documentation provides specific JSON configuration examples for Claude Desktop on macOS, Linux, and Windows.

Is Shufersal MCP Server open source?

Yes, Shufersal MCP Server is open source. According to the project repository documentation, it is distributed under the MIT License, which permits free use, modification, and distribution of the software.

How does Shufersal MCP Server handle account login?

The server automates browser actions with Puppeteer and stores session data locally in a user data directory. You log into your Shufersal account manually during the first browser launch to preserve authenticated sessions for subsequent searches and cart operations.