README

Groceries MCP Server

MCP Server for different Groceries vendor API, enabling searching groceries and cart update.

Features

Automatic cart creation: add items to the cart based on a provided list
Groceries lookup: lookup for groceries using vendor API

Tools

add_items_to_cart

Add groceries to the basket.
Inputs:
- items(list[CartItemScheam]): items to add to the cart
Returns: Updated cart

search
- Lookup for item in the vendor
- Inputs:
  - item (string): Items to
- Returns: list of items corresponding to search term

Setup

Extract Environment Variables

Rami Levy

log in to the Rami Levy site
In developer tools (click on F12) and execute:

const state = JSON.parse(localStorage.ramilevy);
console.log({
    "VENDOR_ACCOUNT_ID": state.authuser.user.id,
    "VENDOR_API_KEY": state.authuser.user.token,
});

Replace environment variables with the printed values

Local usage

Update the .env file using env.template (requires Gemini)
Update the grocery.txt
Run make compile start_agent

Usage with Claude Desktop

To use this with Claude Desktop, add the following to your claude_desktop_config.json:

UV

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

Build

Docker build:

docker build -t mcp-groceries-server .

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Groceries MCP Server

README

Groceries MCP Server

Features

Tools

Setup

Extract Environment Variables

Rami Levy

Local usage

Usage with Claude Desktop

UV

Build

License

Recommended Servers