MCP Cookidoo
Search Thermomix Cookidoo recipes and manage your lists and meal plan from an AI chat
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 2.2.1
- Listing updated
- 4 days ago
Similar MCP servers
About MCP Cookidoo
MCP Cookidoo is an MCP server for food and drink. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a 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.1Add to claude_desktop_config.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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
COOKIDOO_EMAILCookidoo account e-mailRequiredCOOKIDOO_PASSWORDCookidoo account password (use a unique one)RequiredCOOKIDOO_COUNTRYCookidoo site country code, e.g. ch, de, fr (default fr)COOKIDOO_LANGUAGECookidoo site language, e.g. de-CH, de-DE, fr-FR (default fr-FR)COOKIDOO_DEVICEThermomix recipes are written for: TM5, TM6 or TM7 (default: detected)COOKIDOO_IMAGE_DIRSFolders upload_custom_recipe_image may read, ':'-separated; in the container, mount them read-only (default: upload disabled)
Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Pricing unknown
Needs a Cookidoo account; server price not published
MCP Cookidoo 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 Menus Recommender, Bloody Mary Bar & Grill, Achiote, Fast Food Index and Cook with Loopware.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.