# MCP Cookidoo

> MCP Cookidoo is an MCP server for food and drink. Search Thermomix Cookidoo recipes and manage your lists and meal plan from an AI chat. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/herp75/mcp-cookidoo
- **MCP Registry name:** io.github.herp75/mcp-cookidoo
- **Categories:** [food and drink](https://ai-powered.com/categories/food-and-drink)
- **Listing updated:** 2026-11-14

## About

This unofficial server logs into your own Cookidoo account through the site's private web API, so it can change real data: custom recipes, the shopping list, the weekly meal plan and collections. The README warns that this may conflict with Cookidoo's terms and can break when the site changes, and that a weekly live test watches for breakage.

Tools are marked read, write or destructive, and deleting a custom recipe refuses to run unless `confirm=true` is passed. A guided prompt, `create_thermomix_recipe`, walks the assistant through writing a recipe with Thermomix settings (time, temperature, speed, reverse) for TM5, TM6 or TM7, in English, French or German. Recipes can also be read back as editable JSON, copied from the catalogue and adapted, and given a photo from an allowed local folder.

It runs over stdio from `uv`, a Docker image (amd64 and arm64, signed with cosign) or a Claude Desktop `.mcpb` bundle. An HTTP mode is available and demands a bearer token of at least 32 characters when bound beyond loopback.

## Features

- **Recipe search:** Find recipes by keywords, ingredients and maximum total time.
- **Custom recipe editing:** List, read, create, update, copy and delete recipes on your account.
- **Shopping list control:** Add recipes or hand-typed items, tick them off, rename or clear.
- **Meal plan and collections:** See the week, plan recipes on a day, and manage collections.
- **Thermomix-aware steps:** Steps can carry time, temperature and speed presets for TM5, TM6 or TM7.
- **Destructive-action guard:** Deleting a custom recipe needs an explicit confirm flag.

## Good for

- Ask for dinner ideas using what is in the fridge
- Turn a recipe idea into a custom Cookidoo recipe with machine settings
- Build a shopping list from the week's planned meals
- Reorganise collections and meal plan from a chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-cookidoo --env COOKIDOO_EMAIL='<COOKIDOO_EMAIL>' --env COOKIDOO_PASSWORD='<COOKIDOO_PASSWORD>' -- docker run -i --rm -e COOKIDOO_EMAIL -e COOKIDOO_PASSWORD ghcr.io/herp75/mcp-cookidoo:2.2.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-cookidoo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "COOKIDOO_EMAIL",
        "-e",
        "COOKIDOO_PASSWORD",
        "ghcr.io/herp75/mcp-cookidoo:2.2.1"
      ],
      "env": {
        "COOKIDOO_EMAIL": "<COOKIDOO_EMAIL>",
        "COOKIDOO_PASSWORD": "<COOKIDOO_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-cookidoo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "COOKIDOO_EMAIL",
        "-e",
        "COOKIDOO_PASSWORD",
        "ghcr.io/herp75/mcp-cookidoo:2.2.1"
      ],
      "env": {
        "COOKIDOO_EMAIL": "<COOKIDOO_EMAIL>",
        "COOKIDOO_PASSWORD": "<COOKIDOO_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-cookidoo": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "COOKIDOO_EMAIL",
        "-e",
        "COOKIDOO_PASSWORD",
        "ghcr.io/herp75/mcp-cookidoo:2.2.1"
      ],
      "env": {
        "COOKIDOO_EMAIL": "<COOKIDOO_EMAIL>",
        "COOKIDOO_PASSWORD": "<COOKIDOO_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-cookidoo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "COOKIDOO_EMAIL",
        "-e",
        "COOKIDOO_PASSWORD",
        "ghcr.io/herp75/mcp-cookidoo:2.2.1"
      ],
      "env": {
        "COOKIDOO_EMAIL": "<COOKIDOO_EMAIL>",
        "COOKIDOO_PASSWORD": "<COOKIDOO_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-cookidoo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "COOKIDOO_EMAIL",
        "-e",
        "COOKIDOO_PASSWORD",
        "ghcr.io/herp75/mcp-cookidoo:2.2.1"
      ],
      "env": {
        "COOKIDOO_EMAIL": "<COOKIDOO_EMAIL>",
        "COOKIDOO_PASSWORD": "<COOKIDOO_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `search_recipes`: Search recipes by query, ingredients and maximum total time.
- `get_recipe_details`: Ingredients, steps and times of a recipe by ID.
- `list_custom_recipes`: List custom recipes on your account.
- `get_custom_recipe`: Fetch a custom recipe as editable JSON.
- `generate_recipe_structure`: Validate a new recipe for TM5, TM6 or TM7 and return its JSON.
- `upload_custom_recipe`: Create a custom recipe from that JSON.
- `update_custom_recipe`: Replace an existing custom recipe.
- `copy_recipe_to_custom`: Copy a catalogue recipe into a new custom recipe.
- `upload_custom_recipe_image`: Set a custom recipe photo from a local image.
- `delete_custom_recipe`: Permanently delete a custom recipe; requires confirm=true.
- `get_shopping_list`: Recipes, ingredients and hand-added items with ticked state.
- `add_recipes_to_shopping_list`: Add the ingredients of recipes to the list.
- `remove_recipes_from_shopping_list`: Remove recipes and their ingredients.
- `add_shopping_list_items`: Add items by hand.

## FAQ

### Is this made by Cookidoo or Vorwerk?

No. The README calls it an unofficial project with no affiliation to Cookidoo, Vorwerk or Thermomix.

### What credentials does it need?

Your Cookidoo email and password, set as COOKIDOO_EMAIL and COOKIDOO_PASSWORD, plus an optional country, language and device.

### Can it delete my recipes?

It has delete and replace tools, but `delete_custom_recipe` only runs when called with `confirm=true`.

### How do I install it in Claude Desktop?

Download the `.mcpb` bundle from the latest release and open it, or add a `uv run` entry to claude_desktop_config.json.

### How do I add MCP Cookidoo to Claude Code?

Run this command in your terminal: claude mcp add mcp-cookidoo --env COOKIDOO_EMAIL='<COOKIDOO_EMAIL>' --env COOKIDOO_PASSWORD='<COOKIDOO_PASSWORD>' -- docker run -i --rm -e COOKIDOO_EMAIL -e COOKIDOO_PASSWORD ghcr.io/herp75/mcp-cookidoo:2.2.1

### What are the best alternatives to MCP Cookidoo?

The closest alternatives to MCP Cookidoo are Gasthof Koller Daily Menu, Menus Recommender, Achiote, Bloody Mary Bar & Grill and Fast Food Index.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Gasthof Koller Daily Menu](https://ai-powered.com/mcp/gasthof-koller-daily-menu): Gasthof Koller Daily Menu is an MCP server for food and drink.
- [Menus Recommender](https://ai-powered.com/mcp/menus-recommender): Menus Recommender is an open-source MCP server for food and drink.
- [Achiote](https://ai-powered.com/mcp/achiote): Achiote is an open-source MCP server for food and drink.
- [Bloody Mary Bar & Grill](https://ai-powered.com/mcp/bloody-mary-bar-and-grill): Bloody Mary Bar & Grill is an MCP server for food and drink.
- [Fast Food Index](https://ai-powered.com/mcp/fast-food-index): Fast Food Index is a free MCP server for food and drink.
- [Cook with Loopware](https://ai-powered.com/mcp/cook-with-loopware): Cook with Loopware is a free MCP server for food and drink.
- [Herbert & Phyllis Kosher Gifts](https://ai-powered.com/mcp/herbert-and-phyllis-kosher-gifts): Herbert & Phyllis Kosher Gifts is an MCP server for e-commerce.
- [Migros MCP](https://ai-powered.com/mcp/migros-mcp): Migros MCP is an open-source MCP server for e-commerce.

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