Groceries MCP Server
About
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.
Explore
- Automatic cart creation: add items to the cart based on a provided list
- Groceries lookup: lookup for groceries using vendor API
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Groceries MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Update the .env file using env.template (requires Gemini)
2. Update the grocery.txt
3. Run make compile start_agent
To use this with Claude Desktop, add the following to your claude_desktop_config.json:
items
(list[CartItemScheam]): items to add to the cart
item
(string): Items to
1. add_items_to_cart
- Add groceries to the basket.
- Inputs:
- items(list[CartItemScheam]): items to add to the cart
- Returns: Updated cart
2. search
- Lookup for item in the vendor
- Inputs:
- item (string): Items to
- Returns: list of items corresponding to search term
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"groceries mcp server": {
"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>"
}
}
}
}
}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>"
}
}
}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
1.add_items_to_cart
- Add groceries to the basket.
- Inputs:
- items(list[CartItemScheam]): items to add to the cart
- Returns: Updated cart
2. 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
1. log in to the Rami Levy site 2. 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,
});
Local usage
1. Update the.env file using env.template (requires Gemini)
2. Update the grocery.txt
3. Run make compile start_agent
Usage with Claude Desktop
To use this with Claude Desktop, add the following to yourclaude_desktop_config.json:
UV
{
"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>"
}
}
}
}
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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
