MCP.so
Sign In

Groceries MCP Server

@o-b-one

Repository

About Groceries MCP Server

An mcp server for groceries vendors

#groceries

Basic information

Category

Other

Runtime

python

Transports

stdio

Publisher

o-b-one

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "groceries": {
      "command": "uv",
      "args": [
        "run",
        "mcp-groceries-server",
        "--vendor",
        "<vendorName # rami-levy, keshet e.g>"
      ],
      "env": {
        "VENDOR_API_KEY": "<YOUR_API_TOKEN>",
        "VENDOR_ACCOUNT_ID": "<VENDOR_ACCOUNT_ID>"
      }
    }
  }
}

Tools

2

`items`(list[CartItemScheam]): items to add to the cart

Updated cart

Overview

What is Groceries MCP Server?

It is an MCP server that interfaces with grocery vendor APIs (such as Rami Levy and Keshet), enabling users to search for groceries and manage cart updates automatically. It is intended for developers building AI‑powered grocery assistants.

How to use Groceries MCP Server?

Obtain a vendor API key and account ID from the vendor’s website (e.g., from localStorage on the Rami Levy site). Set environment variables (VENDOR_API_KEY, VENDOR_ACCOUNT_ID) in a .env file or in the Claude Desktop configuration. Then run the server via uv run mcp-groceries-server --vendor <vendorName> or use the provided Docker image.

Key features of Groceries MCP Server

  • Automatic cart creation: adds items to the cart from a provided list.
  • Grocery lookup: searches for groceries via vendor APIs.
  • Two MCP tools: add_items_to_cart and search.
  • Supports multiple grocery vendors (e.g., Rami Levy, Keshet).

Use cases of Groceries MCP Server

  • Creating a grocery order by sending a list of items to an AI assistant.
  • Searching for a specific product in a vendor’s catalog before adding it.
  • Automating recurrent grocery purchases through an MCP‑enabled client (like Claude Desktop).

FAQ from Groceries MCP Server

Which vendors are supported?

The README mentions Rami Levy and Keshet as available vendor names when starting the server.

How do I obtain the required credentials?

For Rami Levy, log in to the site, open developer tools (F12), and run the provided JavaScript snippet to extract VENDOR_ACCOUNT_ID and VENDOR_API_KEY from localStorage.

What MCP tools does this server provide?

Two tools: add_items_to_cart (accepts a list of items and returns the updated cart) and search (accepts a search string and returns matching items).

What runtime dependencies are needed?

The server uses uv (a Python package manager) and requires the mcp-groceries-server package. Docker is also supported for building a container.

Where does the grocery data come from?

All data comes directly from the vendor’s own API; no external databases are used. The server acts as a bridge to that API.

Comments

More Other MCP servers

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K