Skip to content
MCP server

handle-mcp

MCP server that plans a budgeted week of groceries and fills the cheapest Danish cart

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
1.9.0
Listing updated
3 days ago

About handle-mcp

handle-mcp is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add handle-mcp -- uvx handle-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "handle-mcp": {
      "command": "uvx",
      "args": [
        "handle-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "handle-mcp": {
      "command": "uvx",
      "args": [
        "handle-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free and open source; groceries and delivery are paid to the store

Prices change. Check handlemcp.dk before you buy.

handle-mcp 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 to handle-mcp

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data