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

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/

Tiv Taam MCP Server