Cookidoo MCP

Recipes / Translation

Translate a Cookidoo recipe with AI.

Create a private translated version with clearer wording, correctly positioned Thermomix settings, and separate steps for ingredients and machine actions.

  • By Cookidoo MCP maintainers
  • 8 min read

Short answer

Copy the official recipe into the account’s private recipes, translate the final text, rebuild guided-cooking annotations against that text, validate, then update ingredients and steps separately. Copying is necessary because Cookidoo’s official recipe-details response does not contain preparation instructions.

Safe sequence

From recipe ID to verified private copy

  1. Connect and identify the exact recipe.

    Use its Cookidoo ID, such as r460132, rather than relying only on a title.

  2. Copy it to private recipes.

    copy_recipe_to_custom creates an editable copy that includes the full ingredient list and preparation instructions.

  3. Read the copied recipe.

    Use get_custom_recipe_details and retain servings, tools, timings, hints, and the new private recipe ID.

  4. Translate for cooking, not word for word.

    Keep quantities and food-safety meaning precise. Explain unfamiliar actions in ordinary language for beginners.

  5. Split mixed instructions.

    A weighing or adding step contains only INGREDIENT annotations. Put mixing, heating, chopping, or another machine action in the following step with TTS or MODE.

  6. Recalculate every text range.

    Positions refer to the translated text in JavaScript UTF-16 units. Use calculate_annotation_position; ordinary Python indexes can be wrong when emoji appear.

  7. Validate before writing.

    Run validate_guided_recipe_structure, show the proposed wording and settings to the user, then PATCH ingredients and steps separately.

  8. Read it back.

    Reload the private recipe and confirm its name, quantities, step order, settings, servings, and URL.

Example request

Tell the assistant what “clear” means.

Translate Cookidoo recipe r460132 into Russian for four servings. Keep quantities exact. Explain each action for a first-time Thermomix user. Always put weighing or adding ingredients in its own step, followed by a separate machine step. Preserve time, temperature, speed, reverse, and supported modes. Show me the translation before saving.

If the source is a web recipe rather than Cookidoo, the assistant can create a new private recipe instead of copying an official one. You should provide the recipe content or a link the assistant is allowed to read.

Quality checklist

What must survive translation

Keep exactAdapt carefully
Ingredient quantities and unitsIngredient names familiar in the target language
Time, temperature, speed, and reverseSentence order and beginner explanations
Servings and Thermomix model/tool contextSafe substitutions explicitly approved by the user
The ingredient/action separation ruleReadable setting phrases used by annotations
Translate first, annotate second.

Any wording change can move a text range. Calculate annotation positions only after the translated sentence is final.

Boundaries

What the workflow does not assume

  • An official recipe image cannot simply be reused on the private copy. Upload only a local image the account owner may use.
  • Translation does not make an unsafe recipe safe. Preserve temperatures and cooking times unless a knowledgeable user approves a change.
  • Do not overwrite an existing private recipe unless the user identifies it and asks for that exact update.
  • Cookidoo endpoints are undocumented and can change; re-read the saved result.

Authored by the Cookidoo MCP maintainers. Workflow and limitations checked against server.py, cookidoo_service.py, schemas, and tests on 29 July 2026.