Skip to main content
Glama
Tiv Taam MCP Server

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: Kroger 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/

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Automated grocery shopping assistant with intelligent unit pricing and automatic coupon clipping, enabling AI to search products, manage carts, and plan grocery runs via Claude Desktop or CLI.
      18
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to do grocery shopping through a logged-in drive session, including product search with labels, Nutri-Score and price per kilo, weekly promotions, usual products, purchase habit analysis, Open Food Facts quality checks, and cart quantity management.
      MIT