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:

Claude Desktop Integration

Add to your claude_desktop_config.json:

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

Available Tools

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/