Cookidoo MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cookidoo MCP Server Turn this curry from my favourite food blog into a Thermomix recipe for my TM6."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Cookidoo MCP Server – Thermomix recipes, meal planning & guided cooking with Claude
Your Thermomix kitchen, run by your AI assistant. Turn any recipe idea or web recipe into a real Cookidoo recipe with guided cooking, find the right dish in the Cookidoo catalogue, plan your week and fill your shopping list, all by just asking Claude (or any other MCP client).
"Turn this curry from my favourite food blog into a Thermomix recipe for my TM6."
"Find three vegetarian dinners under 30 minutes, plan them for Monday to Wednesday and put the ingredients on my shopping list."
"Add the missing Thermomix settings to my bread recipe and knead the dough in dough mode."
Why you'll like it:
Recipes that cook themselves. Uploaded recipes are not just text: every step comes with real Thermomix settings. Tap the step and your Thermomix is set to the right time, temperature and speed. Varoma, reverse and soft stir are included.
Every mode Cookidoo knows. Dough, turbo, blend, warm up and rice cooker, and on the TM7 steaming and browning too. The server reads the available modes live from Cookidoo, so it keeps up when Cookidoo adds new ones.
Ingredients linked like in the official editor. Ingredients in a step become links, exactly as if you had made the recipe in the Cookidoo editor by hand. No manual editing in Cookidoo is needed.
From idea to dinner plan. Search the whole Cookidoo catalogue and your own recipes, plan them in Meine Woche and send the ingredients to your Cookidoo shopping list.
Checked before it is uploaded. Every recipe is checked against the same rules the Cookidoo editor applies before it is uploaded. Invalid temperatures, speeds or modes are explained instead of breaking the upload.
Made for the TM6 and the TM7. Each recipe is built for your device and only uses what it can do.
Disclaimer: This is an unofficial project. The developers are not affiliated with, endorsed by, or connected to Cookidoo, Vorwerk, Thermomix, or any of their subsidiaries or trademarks.
Auf Deutsch: Thermomix-Rezepte mit KI erstellen und die Woche planen
Mit diesem MCP-Server erstellt dein KI-Assistent (z. B. Claude) eigene Thermomix-Rezepte direkt in Cookidoo, aus einer Idee, einem Rezept aus dem Netz oder einem Familienrezept. Die Rezepte landen in „Meine Rezepte“ und funktionieren mit Guided Cooking:
Einstellungen: Zeit, Temperatur, Stufe, Linkslauf und Varoma sind gesetzt.
Modi: Teig kneten, Turbo, Pürieren, Erwärmen und Reis kochen, beim TM7 auch Dampfgaren und Anbraten.
Zutaten: Sie sind in den Schritten verlinkt wie im Cookidoo-Editor.
Nacharbeiten im Editor ist nicht nötig.
Außerdem kann der Assistent:
Suchen: Rezepte im Cookidoo-Katalog und unter deinen eigenen Kreationen finden.
Planen: Rezepte in den Cookidoo-Wochenplan („Meine Woche“) eintragen.
Einkaufen: die Zutaten auf die Cookidoo-Einkaufsliste setzen.
Er funktioniert mit Thermomix TM6 und TM7. Die Einrichtung ist unten beschrieben (englisch). Die Rezepte selbst kannst du auf Deutsch schreiben lassen.
Related MCP server: yes_chef_mcp
What it can do
Create your own recipes
Feature | What you get |
Upload your own recipe | Creates a new recipe in "My recipes" (Meine Rezepte) on Cookidoo, for the TM6 or TM7. |
Thermomix settings (guided cooking) | Settings such as |
Thermomix modes | Dough, turbo, blend, warm up and rice cooker, and on the TM7 also steaming and browning ( |
Ingredient links | When a step contains an ingredient line exactly as it appears in the ingredient list, it is shown as a link, as in recipes made with the Cookidoo editor. |
Check before uploading | Validates the recipe and shows which settings, modes and ingredient links were detected, with a clear reason for anything that does not fit. |
Fix an uploaded recipe | Replaces the steps of a recipe you already uploaded, for example to add Thermomix settings later. Ingredients, times and hints stay unchanged. |
Find, plan and shop
Feature | What you get |
Find recipes | Searches the Cookidoo catalogue (with filters such as ingredients to leave out, maximum time or device) and lists your own recipes. |
Look at a recipe | Shows ingredients, steps and times of a catalogue recipe or one of your own. |
Plan your week | Shows your Cookidoo week plan (Meine Woche), puts catalogue or own recipes on a day and removes them again. |
Shopping list | Adds the ingredients of recipes to your Cookidoo shopping list. |
Setup
You need a Cookidoo account (with an active subscription so you can create your own recipes) and uv, which installs Python and the server for you. No download of this project is needed.
Claude Desktop
Open Settings → Developer → Edit Config and add the server to claude_desktop_config.json:
{
"mcpServers": {
"cookidoo": {
"command": "uvx",
"args": ["mcp-cookidoo"],
"env": {
"COOKIDOO_EMAIL": "your-email@example.com",
"COOKIDOO_PASSWORD": "your-password-here"
}
}
}
}Restart Claude Desktop. The Cookidoo tools now show up in the tool list.
Claude Code
claude mcp add cookidoo -e COOKIDOO_EMAIL=your-email@example.com -e COOKIDOO_PASSWORD=your-password-here -- uvx mcp-cookidooOther countries
The server uses the German Cookidoo by default. For another country add, for example,
"COOKIDOO_COUNTRY": "fr" and "COOKIDOO_LANGUAGE": "fr-FR" to env. The Thermomix settings in
steps are always written in German notation (see below).
Running from a source checkout
For development, or if you prefer not to use uvx:
git clone https://github.com/tobilektri/mcp-cookidoo.git
cd mcp-cookidoo
python -m venv venv
source venv/bin/activate # Windows: .\venv\Scripts\Activate.ps1
pip install -e ".[dev]"
cp .env.example .env # then enter your Cookidoo login in .envIn the MCP client use the command /path/to/mcp-cookidoo/venv/bin/mcp-cookidoo (Windows:
C:\\path\\to\\mcp-cookidoo\\venv\\Scripts\\mcp-cookidoo.exe) instead of uvx. The .env file
stays on your computer and is excluded from git. fastmcp run server.py in the project folder
starts the server as well.
Using it
Copy the example prompt below into your assistant and replace the dish in the first line. It contains everything the assistant needs to know to get the Thermomix settings and ingredient links right. You can write it in any language; the last rule decides the language of the recipe.
Create a Thermomix recipe for [DISH, e.g. "vegetable curry for 4 people"] and save it to my
Cookidoo account with the Cookidoo tools.
Rules for the recipe:
- Ingredients: one per line, short and without preparation notes ("1 Zwiebel", not
"1 Zwiebel, halbiert"). Notes like "halbiert" go into the step.
- Every ingredient must appear in a step exactly as written in the ingredient list, word for
word, so that it is linked. Write "1 Zwiebel in den Mixtopf geben", not "die Zwiebel".
- Write each Thermomix setting in Cookidoo notation as time/temperature/speed, in German, e.g.
"5 Sek./Stufe 5", "3 Min./120°C/Stufe 1", "15 Min./100°C/Linkslauf/Stufe 1" or
"12 Min./100°C/Linkslauf/Sanftrührstufe".
- Use Thermomix modes (dough, turbo, blend, ...) where they fit, written exactly as
get_thermomix_modes shows them, e.g. "Teig kneten/2 Min." or "Turbo/1 Sek.".
- Use only one Thermomix setting or mode per step; split longer processes into several steps.
- The recipe is for my [TM6 / TM7].
- Write the recipe in German.
Process:
1. Connect with connect_to_cookidoo.
2. Call get_thermomix_modes for my device and use only the modes and values it lists.
3. Check the recipe with generate_recipe_structure (with my device). If the output lists
warnings, unlinked ingredients or unrecognised settings, fix the steps and check again until
everything is linked.
4. Show me the recipe and wait for my OK.
5. Upload it with upload_custom_recipe and give me the recipe ID and link.The assistant then works through these tools:
connect_to_cookidoosigns in.get_thermomix_modeslists the modes Cookidoo offers for the device and how to write them.generate_recipe_structurechecks the recipe and reports detected settings, modes and links.upload_custom_recipesaves it to your account and returns the recipe ID and link.
Planning the week
You can also ask the assistant to find recipes and plan them, for example:
Connect to Cookidoo. Find three quick vegetarian dinners (at most 30 minutes, for my TM6)
in the Cookidoo catalogue or among my own recipes, show them to me and, after my OK, plan
them for Monday to Wednesday next week and put their ingredients on my shopping list.The assistant uses search_recipes and list_my_recipes to find recipes, get_recipe_details
to look at them, and plan_recipe, get_week_plan and add_to_shopping_list to plan and shop.
All tools
Tool | Purpose |
| Sign in. Call this first. |
| List the modes Cookidoo offers right now for the TM6 or TM7, with spelling and allowed values. |
| Search the Cookidoo catalogue. All filters are optional; Cookidoo returns up to 20 results per page. |
| List your own recipes with ID, device and time. |
| Show ingredients, steps and times of a catalogue recipe ( |
| Show the recipes planned in the week starting at |
| Plan one or more recipes (comma-separated, catalogue and own mixed) on a day. |
| Remove a recipe from a day of the week plan. |
| Add the ingredients of recipes to the Cookidoo shopping list. |
| Validate a recipe and preview the detected settings, modes and links. |
| Create the recipe on Cookidoo (pass the JSON from |
| Replace all steps of one of your recipes. The device is taken from the recipe. Without |
You don't have to call get_thermomix_modes for the checks to work: checking, uploading and
updating always read the modes from Cookidoo themselves before building the steps. Without a
connection, generate_recipe_structure uses a built-in list and says so.
Ingredients, steps and hints are passed one per line. List markers such as 1. or - at the start
of a step are removed.
Writing Thermomix settings
Write the settings into the step text the way Cookidoo prints them, as time/temperature/speed:
In the step | Meaning |
| 4 seconds, speed 5 |
| 3 minutes, 120 °C, speed 1 |
| 1 minute 30 seconds, 90 °C, speed 2 |
| reverse (counter-clockwise) |
| reverse with soft stir ( |
| Varoma temperature (TM6 only) |
| speed 0.5 |
Example step:
1 Zwiebel in den Mixtopf geben und 5 Sek./Stufe 5 zerkleinern.Rules (the same ones the Cookidoo editor applies):
Speeds 0.5 to 10 in half steps and soft stir are valid. The temperature is optional and one of the Thermomix steps from 37 to 120 °C (37, 40, 45 … 95, 98, 100, 105, 110, 115, 120).
With heating, the speed can be at most 6.
Times up to 5 minutes in 10-second steps, up to 20 minutes in half minutes, then whole minutes, at most 99 minutes. Other times are used, but the tool output warns about them.
The notation is the German one (
Min.,Sek.,Stufe,Linkslauf), whatever language the rest of the recipe is in.Invalid values (e.g.
Stufe 12or42°C) stay plain text, and the tool output says why.Not supported yet: Fahrenheit.
Thermomix modes
Write the mode name as Cookidoo shows it, then its values, separated by /:
In the step | Mode | Device | Allowed values |
| dough (also | TM6, TM7 | 1 second to 20 minutes |
| turbo | TM6, TM7 | 0.5, 1 or 2 seconds |
| turbo with pulses | TM7 | 1 to 9 pulses |
| blend | TM6, TM7 | 10 seconds to 5 minutes, speed 6 to 8 |
| warm up | TM6, TM7 | 37 to 90 °C, soft stir (default), speed 1 or 2 |
| rice cooker | TM6, TM7 | none (the brackets mark it as a mode) |
| steaming | TM7 | up to 99 minutes, soft stir to speed 5, optional |
| browning | TM7 | 140 to 160 °C, up to 30 minutes (default 10), |
In the recipe the step then shows the mode the way Cookidoo does (name, mode icon and time, e.g. "Teig kneten" with the dough icon and "2 Min."), and tapping it starts the mode on the Thermomix.
The list above is the state of October 2026. The server reads the current list from Cookidoo
(get_thermomix_modes): a mode Cookidoo stops offering is no longer used, and a new one is listed
as "not supported yet" until the server knows its values.
Ingredient links
An ingredient is linked when its line from the ingredient list appears word for word in a step.
Ingredient list | Step | Linked? |
|
| yes |
|
| no |
Short ingredient lines (1 Zwiebel instead of 1 Zwiebel, halbiert) keep the steps readable.
The tool output lists which ingredients are linked and which are not.
Like the Cookidoo editor, the server replaces ; with a full-width semicolon (;) in ingredients
and steps.
Fixing an uploaded recipe
Forgot the settings, or a link is missing? Pass the recipe ID (from the upload output or the URL of
the recipe on Cookidoo) and the complete new list of steps to update_custom_recipe_steps. It
replaces all steps and leaves everything else alone.
Development
The code lives in the mcp_cookidoo package. In a source checkout (see above) run the tests for
the settings, modes, links and recipe helpers with:
pytestThe files in fixtures/ are the settings dialog of the Cookidoo editor (TM6 and TM7) and steps
the editor itself produced; the tests check that the server builds exactly the same.
Format and lint:
black .
ruff check .Releasing
Set the new version in
pyproject.toml,mcp_cookidoo/__init__.py,fastmcp.jsonand twice inserver.json.Commit, then tag and push:
git tag v1.0.1 && git push origin v1.0.1.
The GitHub Actions workflow publish.yml runs the tests, publishes the package to
PyPI and the server to the
MCP Registry.
Acknowledgments
This project started as a fork of alexandrepa/mcp-cookidoo by Alexandre Patelli, who built the first version of the server (login, recipe structure and upload). Thank you!
It is built on top of cookidoo-api, which provides the Python interface to the Cookidoo platform. Special thanks for making this integration possible!
License
MIT, see LICENSE.
Available Tools
12 toolsadd_to_shopping_listAdd To Shopping ListA
Add the ingredients of one or more recipes to your Cookidoo shopping list.
Catalogue recipes ("r59322") and your own recipes ("01M5...") can be mixed. You must be connected first using connect_to_cookidoo.
Inputs: recipe_ids (required). Returns: result
connect_to_cookidooConnect To CookidooA
Authenticate with Cookidoo and store the session.
This tool must be called before using other Cookidoo tools. It will:
Load your Cookidoo credentials from the .env file
Authenticate with the Cookidoo platform
Store the authenticated session for use by other tools
Inputs: no named parameters. Returns: result
generate_recipe_structureGenerate Recipe StructureA
Generate and validate a recipe structure ready for upload to Cookidoo.
This tool helps you structure your recipe data properly before uploading. It validates all fields and returns a JSON structure that can be used with the upload_custom_recipe tool. The modes are checked against what Cookidoo offers right now (call get_thermomix_modes to see them and their spelling).
Thermomix settings: write them inside the step text in Cookidoo notation and they are turned into real Thermomix settings (guided cooking) on upload: "4 Sek./Stufe 5" time/speed "3 Min./120°C/Stufe 1" time/temperature/speed "15 Min./100°C/Linkslauf/Stufe 1" counter-clockwise (reverse) stirring "12 Min./100°C/Linkslauf/Sanftrührstufe" soft stir (Sanftrührstufe) "20 Min./Varoma/Stufe 1" Varoma (TM6 only) "1 Min. 30 Sek./Stufe 0,5" minutes and seconds, half speed Temperatures 37-120 °C in Cookidoo's steps (37, 40, 45 ... 95, 98, 100, 105 ...), heating only up to speed 6.
Inputs: name (required), steps (required), ingredients (required), hints, +4 more. Returns: result
get_recipe_detailsGet Recipe DetailsA
Get ingredients, steps and times of a recipe by its ID.
Works for Cookidoo catalogue recipes (e.g. "r59322", from search_recipes) and for your own recipes (e.g. "01M5A79NY53CEKEW6NKVYBFSTW", from list_my_recipes). Steps of own recipes are shown in the notation update_custom_recipe_steps accepts. You must be connected first using connect_to_cookidoo.
Inputs: recipe_id (required). Returns: result
get_thermomix_modesGet Thermomix ModesA
List the Thermomix modes Cookidoo offers right now and how to write them in a step.
Call this before writing a recipe that uses modes (dough, turbo, blend, warm up, rice cooker, and for the TM7 steaming and browning). The list is read live from the Cookidoo recipe editor, so new or removed modes show up here. Normal settings (time/temperature/speed, e.g. "3 Min./120°C/Stufe 1") always work in addition.
Inputs: device. Returns: result
get_week_planGet Week PlanA
Show the recipes planned in your Cookidoo week plan ("Meine Woche").
You must be connected first using connect_to_cookidoo.
Inputs: day. Returns: result
list_my_recipesList My RecipesA
List your own (created) Cookidoo recipes with name, ID, device and total time.
You must be connected first using connect_to_cookidoo.
Inputs: no named parameters. Returns: result
plan_recipePlan RecipeA
Put one or more recipes into your Cookidoo week plan on a given day.
Catalogue recipes ("r59322") and your own recipes ("01M5...") can be mixed. You must be connected first using connect_to_cookidoo.
Inputs: day (required), recipe_ids (required). Returns: result
search_recipesSearch RecipesA
Search the Cookidoo recipe catalogue.
Returns names, IDs and links. Use get_recipe_details with an ID for ingredients and steps, and plan_recipe to put a recipe into the week plan. Your own recipes are not part of the catalogue; use list_my_recipes for them. You must be connected first using connect_to_cookidoo.
Inputs: query (required), page, limit, device, +5 more. Returns: result
unplan_recipeUnplan RecipeA
Remove a recipe from your Cookidoo week plan on a given day.
You must be connected first using connect_to_cookidoo.
Inputs: day (required), recipe_id (required). Returns: result
update_custom_recipe_stepsUpdate Custom Recipe StepsA
Replace the steps of an existing custom recipe, including Thermomix settings and ingredient links.
Use this to fix or add Thermomix settings (time, temperature, speed, reverse, soft stir), modes (dough, turbo, ...) and ingredient links on a recipe that was already uploaded. Only the steps are changed; ingredients, times and hints stay as they are. The device (TM6/TM7) is taken from the recipe, the modes are read from Cookidoo. You must be connected first using connect_to_cookidoo.
Write the settings inside the step text in Cookidoo notation, for example "3 Min./120°C/Stufe 1", "12 Min./100°C/Linkslauf/Sanftrührstufe" or "Teig kneten/2 Min." (see generate_recipe_structure and get_thermomix_modes for all forms). Ingredient lines that appear verbatim in a step become links.
Inputs: steps (required), recipe_id (required), ingredients. Returns: result
upload_custom_recipeUpload Custom RecipeA
Upload a custom recipe to your Cookidoo account.
This tool creates a brand new recipe from scratch on your Cookidoo account. Use 'generate_recipe_structure' first to validate your recipe data, then pass the resulting JSON to this tool.
Thermomix settings and modes written in the step texts (e.g. "3 Min./120°C/Stufe 1", "Teig kneten/2 Min.") are uploaded as real Thermomix settings, and ingredient lines that appear verbatim in a step are uploaded as ingredient links, so no manual editing in Cookidoo is needed. The modes are read from Cookidoo right before the upload.
Inputs: recipe_json (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have clearly distinct purposes, but generate_recipe_structure and upload_custom_recipe are closely related (validation vs creation), and update_custom_recipe_steps only handles a subset of recipe editing. The descriptions do clarify the boundaries, so confusion is limited.
All names use snake_case and follow a verb-based pattern, which is consistent overall. Minor deviations like connect_to_cookidoo and add_to_shopping_list include prepositions, but the intent remains clear.
With 12 tools, the set is well-scoped: it covers authentication, recipe discovery, week planning, shopping lists, and custom recipe creation without obvious redundancy. Each tool has a clear role in the domain.
Notable gaps exist: you can only update steps of a custom recipe (not ingredients, times, or hints), there's no tool to delete recipes, and shopping list management only supports adding (no view or remove). These omissions could cause agent failures in common workflows.
Maintenance
Related MCP Connectors
Recipe search, ingredient matching, nutrition filters and a private cookbook for any AI agent.
Search, save, organize, cook, and share recipes with any AI assistant.
AI-powered kitchen management — pantry, recipes, meal plans, shopping lists
A recipe book and meal planner. Your AI assistant keeps your recipes and plans the week's dinners.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceLets Claude read recipes from your Cookidoo account and create TM7-optimized custom recipes with guided-cooking annotations, quality scoring, and automatic rollback on upload failure.MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to search recipes, compose nutritionally balanced meals, optimize weekly meal plans based on macro targets for family members, and generate consolidated grocery lists from a personal recipe database.-
- AlicenseNot gradedqualityBmaintenanceMCP server for Cookidoo, enabling AI tools to search recipes, manage shopping lists, and retrieve account and subscription information.2GPL 3.0
- AlicenseAqualityDmaintenanceEnables LLMs to upload and manage Thermomix recipes on Cookidoo, including structured steps with Thermomix settings, images, and access to shopping lists and meal planning.11MIT