# handle-mcp

The handle-mcp MCP server for Claude Code compares grocery baskets at nemlig.com, BilkaToGo, and REMA 1000. It plans meals around a budget and fills the lowest-priced cart.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 161 repo stars
- Author: NJohansen
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NJohansen/handle-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/handle-mcp

## What it does

handle-mcp searches products and offers, then compares each basket with pack sizes, delivery charges, and minimum order amounts included. It can add the items to the cart at the cheapest store. Other tools find recipes and their ingredients, show nutrition details, and list delivery slots. The server cannot place an order or pay; the shopper reviews the cart and completes the purchase.

It requires `uv`, an MCP client, and an account with one of the stores. `uv` can fetch Python 3.12 or later if needed. nemlig.com and BilkaToGo require home delivery to the account holder's address; REMA 1000 supports Køb & Hent or shopping in store. Windows on ARM is unsupported because `cryptography` has no ready-made build for that architecture. Anonymous usage counting stays off unless the user opts in.

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

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- compare a grocery list across several stores
- plan weekly meals within a food budget
- add a recipe's ingredients to a cart
- find free or lower-cost delivery slots

## Example prompts
- Plan this week's meals within my budget and fill the cheapest cart.
- Find this week's offers and any free gifts.
- Which delivery slots cost less tomorrow?

## Similar
- [kronan-mcp](https://affpapa.org/en/nevibecode/mcp/kronan-mcp.md) — MCP server · ★ 18 repo stars
- [texas-grocery](https://affpapa.org/en/nevibecode/mcp/texas-grocery.md) — MCP server · ★ 72 repo stars
- [firecrawl-shop](https://affpapa.org/en/nevibecode/skills/firecrawl-shop.md) — skill · 31600 installs
- [handle-complaint](https://affpapa.org/en/nevibecode/skills/handle-complaint.md) — skill · ★ 38 repo stars
- [recipe-card-creator](https://affpapa.org/en/nevibecode/skills/recipe-card-creator.md) — skill · 183 installs
- [hunt-a-handle](https://affpapa.org/en/nevibecode/skills/hunt-a-handle.md) — skill · 1900 installs

---
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
