# handle-mcp

> handle-mcp is an open-source MCP server for e-commerce. MCP server that plans a budgeted week of groceries and fills the cheapest Danish cart. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://handlemcp.dk
- **Repository:** https://github.com/njohansen/handle-mcp
- **MCP Registry name:** io.github.NJohansen/handle-mcp
- **Categories:** e-commerce
- **Listing updated:** 2026-11-14

## About

HandleMCP is aimed at busy Danish families who want one shop a week. You state a budget, such as 700 kr. for four people, along with likes, dislikes and what you already have. The server reads the week's offers across nemlig.com, BilkaToGo and REMA 1000, prices the same basket in every store including delivery fees, and fills the cheapest cart.

The human always pays. The README says no code exists to order, pay, choose a delivery time or change an address, and a test fails if someone adds it. Names, addresses and phones are stripped before the assistant sees store responses, and logins stay on your computer. Only two tools write: `set_cart_quantities` and `add_recipe_to_cart`, the latter after your yes.

Anonymous usage counts are on by default and can be turned off with `HANDLE_TELEMETRY=0`.

## Features

- **Three-store comparison:** compare_basket prices a list in every store with fees, cheapest first.
- **Offer-based planning:** list_offers surfaces this week's offers and free items.
- **Recipes with prices:** Recipe tools return the products needed for any number of people.
- **Delivery slots:** Free times are listed cheapest first.
- **Cannot pay:** No ordering or payment code exists; a failing test guards it.

## Good for

- Plan a week of dinners under a fixed budget
- Find which store is cheapest for a shopping list
- Fill a cart with a recipe's ingredients
- Check nutrition per 100 g from the label

## Install

### Claude Code (Terminal)

```sh
claude mcp add handle-mcp -- uvx handle-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "handle-mcp": {
      "command": "uvx",
      "args": [
        "handle-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "handle-mcp": {
      "command": "uvx",
      "args": [
        "handle-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "handle-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "handle-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "handle-mcp": {
      "command": "uvx",
      "args": [
        "handle-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "handle-mcp": {
      "command": "uvx",
      "args": [
        "handle-mcp"
      ]
    }
  }
}
```

## Tools

- `search_products`: Price, price per kg or litre, and offers
- `search_recipes`: Searches the store's recipes
- `list_recipes`: Lists featured recipes
- `get_recipe`: Products to buy for a recipe
- `list_offers`: This week's offers and free gifts
- `get_nutrition`: Nutrition per 100 g or ml
- `compare_basket`: Prices a list in every store
- `get_cart`: Cart lines, fees and total
- `set_cart_quantities`: Sets cart quantities (writes)
- `add_recipe_to_cart`: Adds a recipe's products to the cart (writes)
- `get_delivery_info`: Chosen time and fees
- `list_delivery_slots`: Free delivery times
- `get_orders`: Past orders
- `get_order`: One past order

## FAQ

### Can it place an order?

No. You check the cart, pick a delivery time and pay yourself.

### What does it cost?

The site says HandleMCP is free and open source; groceries are paid to the store.

### Which stores?

nemlig.com, BilkaToGo and REMA 1000.

### Does it collect data?

Anonymous usage counts, which can be disabled with HANDLE_TELEMETRY=0.

### Is handle-mcp free?

Yes. handle-mcp is open source, so you can use and self-host it for free.

### How do I add handle-mcp to Claude Code?

Run this command in your terminal: claude mcp add handle-mcp -- uvx handle-mcp

### What are the best alternatives to handle-mcp?

The closest alternatives to handle-mcp are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/handle-mcp
