Cookidoo Recipe Creator for Thermomix

Convert any recipe from the web into Thermomix format and upload it directly to your Cookidoo account — all through Claude Code + Chrome DevTools MCP.

Supports: TM7 • TM6 • TM5 • TM31 • 8 languages

---

What does this do?

1. You share a recipe — a URL, pasted text, screenshot, or PDF
2. Claude converts it to Thermomix format (speeds, times, temperatures)
3. Uploads it directly to your Cookidoo account via API — with linked ingredients and Thermomix actions properly annotated
4. Optionally generates a recipe image if you don't provide one

---

Quick Start

Prerequisites

• Claude Code installed
• A Cookidoo account with active subscription
• Google Chrome browser (only required for Cookidoo upload — not needed if you just want .md / .pdf output)

1. Install Chrome DevTools MCP

Add to your Claude Code settings (~/.claude/settings.json):

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/chrome-devtools-mcp@latest"]
    }
  }
}

For full setup instructions, see the Chrome DevTools MCP docs.

2. Open Chrome with remote debugging

Windows — Create a shortcut with this target:

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

Mac — Run in terminal:

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

Linux — Run in terminal:

google-chrome --remote-debugging-port=9222

3. Add the skill to Claude Code

Copy the cookidoo-recipe.md file from this repo to your Claude Code skills directory:

# Create skills directory if it doesn't exist
mkdir -p ~/.claude/skills

# Download the skill
curl -o ~/.claude/skills/cookidoo-recipe.md https://raw.githubusercontent.com/guimatheus92/cookidoo-recipe-creator/main/cookidoo-recipe.md

4. Use it

1. Open Chrome (with the debugging shortcut)
2. Go to your Cookidoo site and log in
3. In Claude Code, say:

Convert this recipe for my Thermomix TM7 and upload to Cookidoo:
https://example.com/chocolate-cake-recipe

Or paste the recipe text directly:

Convert this to TM7 and upload to Cookidoo:

Ingredients: 200g flour, 100g sugar, 2 eggs, 150g butter...
Instructions: Mix flour and sugar, add eggs...

Claude will ask you to confirm the model, language, and servings, then handle everything automatically.

---

How It Works

1. Recipe Conversion

Claude converts standard recipes to Thermomix format using these typical operations:

| Operation | Thermomix Setting | |---|---| | Chop/grind | 5-10 sec / speed 7-10 | | Mix dry ingredients | 5 sec / speed 4 | | Cream butter + sugar | 1 min / speed 4 | | Add egg/liquids | 20 sec / speed 3 | | Fold in dry ingredients | 15 sec / speed 2, reverse | | Add chunks (don't crush) | 10 sec / speed 1, reverse | | Knead dough | 2 min / knead mode | | Cook/sauté | X min / temp°C / speed 1 | | Steam (Varoma) | X min / Varoma / speed 1 |

2. The Cookidoo API

Cookidoo doesn't provide a public API, but the web app uses internal REST endpoints that we can call from the browser context. This project uses two endpoints:

Create a recipe:

POST /created-recipes/{locale}
Body: { "recipeName": "My Recipe" }

Update a recipe (ingredients, steps, metadata):

PATCH /created-recipes/{locale}/{recipeId}
Body: {
  ingredients: [{ type: "INGREDIENT", text: "228 g flour" }],
  instructions: [{
    type: "STEP",
    text: "Add 228 g flour.",
    annotations: [{
      type: "INGREDIENT",
      data: { description: "228 g flour" },
      position: { offset: 4, length: 11 }
    }]
  }],
  tools: ["TM7"],
  totalTime: 9000,  // seconds
  prepTime: 1200,   // seconds
  yield: { value: 4, unitText: "portion" }
}

Key discovery: Cookidoo supports two annotation types in steps:

• INGREDIENT — links text to an ingredient from the list (renders as bold/highlighted)
• TTS (Thermomix Time/Speed) — marks machine actions with speed, time, and temperature

Without annotations, ingredients appear as plain text. With annotations, they are linked and interactive — just like official Vorwerk recipes.

Read vs write: GET /created-recipes/{locale}/{recipeId} returns a different, schema.org-style shape — recipeContent.recipeIngredient / recipeInstructions as plain strings, totalTime as an ISO-8601 duration like PT2H30M, plus tool and recipeYield. Annotations aren't echoed back. This read-back is a browser-free way to verify an upload succeeded.

Authentication is handled automatically through browser cookies when using Chrome DevTools MCP (Option A), or by sending the session cookie as a header when running via Node/curl (Option C).

3. Output

Claude generates:

• Cookidoo recipe — uploaded directly to your account with linked ingredients and TTS annotations (if browser connected)
• Recipe image — uses your provided image, or generates one automatically

---

Supported Models

| Feature | TM7 | TM6 | TM5 | TM31 | |---|:---:|:---:|:---:|:---:| | Max temperature | 180°C | 160°C | 120°C | 100°C | | Guided cooking | Yes | Yes | No | No | | Slow cook mode | Yes | Yes | No | No | | Built-in scale | Yes | Yes | Yes | No | | Reverse blade | Yes | Yes | Yes | Yes | | Max speed | 10 | 10 | 10 | 10 |

If a recipe requires temperatures above your model's limit (e.g., 180°C on a TM5), Claude will suggest using the oven for that step instead.

---

Supported Languages

| Language | Cookidoo Domain | Locale | |---|---|---| | Portuguese (Portugal) | cookidoo.pt | pt-PT | | Portuguese (Brazil) | cookidoo.com.br | pt-BR | | English (US) | cookidoo.thermomix.com | en-US | | English (UK) | cookidoo.co.uk | en-GB | | German | cookidoo.de | de-DE | | Spanish | cookidoo.es | es-ES | | French | cookidoo.fr | fr-FR | | Italian | cookidoo.it | it-IT |

Heads-up: the created-recipes API runs on whichever host your browser session is logged into — frequently cookidoo.international rather than the regional portal above. Created recipes are tied to your Vorwerk account, so they appear on every portal you log into regardless of which host created them. If uploads 401 or redirect, confirm the host (where your v-authenticated cookie is scoped) and the locale (GET /created-recipes/{locale} should return JSON, not a 307). Example: on cookidoo.international, pt-BR works while en-US/pt-PT redirect to /en.

---

Alternative Setup (No Chrome / No MCP)

Google Chrome and the DevTools MCP are only required if you want to upload recipes directly to Cookidoo. There are three usage modes:

| Mode | Chrome needed? | MCP needed? | What you get | |---|:---:|:---:|---| | Full (recommended) | Yes | Yes | Cookidoo upload with annotations + image | | Manual cookie | Any browser | No | Cookidoo upload with annotations | | Offline | No | No | Recipe conversion only (no upload) |

Manual cookie approach

If you don't want to install Chrome DevTools MCP, you can manually provide the auth cookie from any browser (Chrome, Firefox, Edge, Safari):

1. Open Cookidoo in your browser and log in
2. Press F12 to open Developer Tools
3. Go to Application tab (Chrome/Edge) or Storage tab (Firefox) → Cookies → click your Cookidoo domain
4. Find the cookie named v-authenticated (and _oauth2_proxy)
5. Copy the value(s) and share with Claude

The cookie expires after some time, so you may need to repeat this.

Running it with no browser automation at all: once Claude has the cookie (or a cookies.txt export), it executes the POST/PATCH directly via Node (fetch, Node 18+) or curl -b cookies.txt — no Chrome, no MCP. This is the most reliable path if you only have Edge/Firefox. The repo ships a helper:

node scripts/upload-recipe.mjs --cookies cookies.txt --recipe my-recipe.json

See scripts/README.md for the recipe-spec format.

⚠️ A full-browser cookies.txt export contains every site's cookies (banking, email, live sessions). Share only the Cookidoo lines (v-authenticated, _oauth2_proxy), or delete the export immediately after use.

---

Offline Mode (No Cookidoo Upload)

If you just want the recipe converted without uploading to Cookidoo:

Convert this recipe for my Thermomix TM6, don't upload:
https://example.com/pasta-recipe

Claude will convert the recipe to Thermomix format with proper speeds, times, and temperatures. No browser setup required for this mode.

---

FAQ

General

Q: Is this an official Thermomix/Cookidoo product? No. This is a community project that uses Cookidoo's internal web API. It is not endorsed by or affiliated with Vorwerk, Thermomix, or Cookidoo.

Q: Do I need a Cookidoo subscription? Yes. You need an active Cookidoo subscription to create and save custom recipes. The "Created Recipes" feature requires a paid plan.

Q: Is this free? This skill itself is free and open source. You need a Claude Code subscription and a Cookidoo subscription.

Q: Can I convert recipes from any website? Yes. Claude accepts recipes in multiple formats: a URL (from any cooking website), pasted text (copy from a book, message, or app), a screenshot (photo of a reci