# yandex-lavka-mcp

Hands your assistant the Lavka catalog, cart and checkout, running on your own browser session. No charge happens until you confirm a previewed total.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 25
- Author: Dudude-bit
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Dudude-bit/yandex-lavka-mcp
- Updated: 2026-10-05
- HTML: https://affpapa.org/en/nevibecode/mcp/yandex-lavka-mcp

## What it does

Yandex Lavka has no public API, so this server talks to the private web API behind `lavka.yandex.ru` using your cookies. Log in at the site first, then get the session into `~/.config/yandex-lavka-mcp/config.json`: `import_cookies.py` takes a Cookie header copied from DevTools, and on macOS a separate script pulls cookies out of Chrome. Sessions expire, and once calls fail with an authorization error you have to import them again.

Delivery location scopes everything — catalog, prices, cart. Pick a saved address by name or type any address with its city; until a point is set, product search returns nothing. Tools cover catalog search, product details with nutrition per 100 g and per portion, quantity edits, cart totals, saved cards, live orders and history.

Spending is gated. `checkout_preview` lays out items, subtotal, discount, delivery, ETA and total without touching your card. `confirm_order` refuses unless a preview was just run and you echo back its exact total; editing the cart makes that preview void. Banks that demand 3-D Secure will not settle a headless charge — you get a redirect link to finish payment yourself. It is unofficial and rides a private API, so expect breakage, and Lavka's terms likely forbid this route.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add yandex-lavka-mcp -- uvx yandex-lavka-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from yandex-lavka-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add yandex-lavka-mcp -- uvx yandex-lavka-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from yandex-lavka-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yandex-lavka-mcp": {
            "command": "uvx",
            "args": [
                "yandex-lavka-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from yandex-lavka-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yandex-lavka-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "yandex-lavka-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from yandex-lavka-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add yandex-lavka-mcp uvx yandex-lavka-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from yandex-lavka-mcp <command>

## When to use it
- Search the catalog for a specific delivery address
- Build a cart and fix item quantities
- See the full order total before paying
- Check saved cards and track active orders
- Cancel an order by its id

## Example prompts
- Run `lavka_status` and tell me which delivery point is currently set
- Find milk and buckwheat in the catalog and put one of each in the cart
- Do a `checkout_preview` and show me the total without ordering

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md