Skip to main content
Glama
danielJL-altius

Tiv Taam MCP Server

Tiv Taam MCP Server

A local Model Context Protocol server that lets you shop at Tiv Taam through Claude — including recipe-driven cart population.

Features

  • Login with your Tiv Taam credentials (email + password)

  • Search products in Hebrew or English

  • Parse recipes — free text or URL — into ingredient lists

  • Match ingredients to the best available products

  • Add to cart — individual items or an entire recipe in one shot

Related MCP server: Groceries MCP Server

Setup

Prerequisites

  • uv package manager

Install

cd tiv
uv sync

Configuration

Copy .env.example to .env and adjust if needed:

cp .env.example .env

Key settings:

Variable

Default

Description

TIVTAAM_RETAILER_ID

1062

Tiv Taam retailer ID

TIVTAAM_BRANCH_ID

943

Branch ID (943 = Netanya)

TIVTAAM_MAX_SEARCH_RESULTS

8

Max results per search

Claude Desktop Integration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "tivtaam": {
      "command": "uv",
      "args": ["--directory", "/path/to/tiv", "run", "tivtaam-mcp"]
    }
  }
}

Available Tools

Tool

Description

login_status

Check if you're logged in

login

Log in with email & password

set_shopping_preferences

Set organic/budget/brand prefs

search_products

Search for products by keyword

plan_recipe_ingredients

Parse a recipe into ingredients

match_recipe_to_products

Find best product matches for a recipe

view_cart

See your current cart

add_items_to_cart

Add specific products by ID

add_recipe_to_cart

Parse recipe & add to cart in one step

Example Prompts

  • "Search for hummus"

  • "What's in my cart?"

  • "Add recipe to cart: 400g pasta, 3 garlic cloves, 100ml olive oil"

  • "Plan the ingredients for this recipe: [URL]"

Running Tests

uv run pytest tests/

Related MCP Connectors

Related MCP Servers