Cookidoo for Thermomix (unofficial)

Cookidoo MCP サーバー – Thermomix のレシピ、献立計画、Claude によるガイド付き調理

AI アシスタントに任せる、あなたの Thermomix キッチン。 レシピのアイデアやウェブ上のレシピを、ガイド付き調理に対応した実際の Cookidoo レシピに変換したり、Cookidoo カタログからぴったりの料理を見つけたり、1週間の献立を計画して買い物リストを作成したりできます。Claude（またはほかの MCP クライアント）に頼むだけです。

「お気に入りの料理ブログに載っていたこのカレーを、TM6 用の Thermomix レシピにして。」

「30分以内に作れるベジタリアンの夕食を3つ見つけて、月曜日から水曜日までの献立にして、材料を買い物リストに追加して。」

「パンのレシピに足りない Thermomix の設定を追加して、生地モードでこねて。」

おすすめの理由：

• レシピにおまかせ。 アップロードしたレシピは単なるテキストではありません。各手順に実際の Thermomix 設定が含まれます。手順をタップすれば、Thermomix が適切な時間、温度、速度に設定されます。Varoma、逆回転、やさしく混ぜる設定にも対応しています。
• Cookidoo が対応するすべてのモード。 生地、ターボ、ブレンド、加熱、炊飯器に加え、TM7 では蒸し調理と焼き色付けにも対応します。サーバーは利用可能なモードを Cookidoo からリアルタイムで読み込むため、Cookidoo に新しいモードが追加されても対応できます。
• 公式エディターと同じように材料をリンク。 手順内の材料は、Cookidoo エディターで手動作成したレシピとまったく同じようにリンクされます。Cookidoo で手動編集する必要はありません。
• アイデアから夕食の計画まで。 Cookidoo のカタログ全体と自分のレシピを検索し、「Meine Woche」に献立を登録して、材料を Cookidoo の買い物リストに送れます。
• アップロード前に検証。 すべてのレシピは、Cookidoo エディターが適用するものと同じルールに基づいて、アップロード前に検証されます。無効な温度、速度、モードがあれば、アップロードが失敗する代わりに理由が説明されます。
• TM6 と TM7 向け。 各レシピはお使いのデバイスに合わせて作成され、そのデバイスで可能な機能だけを使用します。

免責事項： これは非公式のプロジェクトです。開発者は Cookidoo、Vorwerk、Thermomix、またはそれらの子会社や商標と提携、推奨、関係していません。

ドイツ語：AI で Thermomix のレシピを作成し、1週間の献立を計画

この MCP サーバーを使うと、AI アシスタント（例：Claude）が、アイデアやウェブ上のレシピ、家族のレシピから、Cookidoo に直接オリジナルの Thermomix レシピを作成できます。レシピは「Meine Rezepte」に保存され、ガイド付き調理に対応します。

• 設定： 時間、温度、速度、逆回転、Varoma が設定されます。
• モード： 生地をこねる、ターボ、ピューレ、加熱、炊飯に対応し、TM7 では蒸し調理と焼き色付けにも対応します。
• 材料： Cookidoo エディターと同じように、手順内でリンクされます。

エディターで後から編集する必要はありません。

さらに、アシスタントは次のことができます。

• 検索： Cookidoo カタログと自分のレシピからレシピを見つけます。
• 計画： レシピをCookidoo の週間計画（「Meine Woche」）に登録します。
• 買い物： 材料をCookidoo の買い物リストに追加します。

Thermomix TM6 と TM7で動作します。セットアップ方法は下記をご覧ください（英語）。レシピ自体はドイツ語で作成できます。

できること

独自のレシピを作成

機能	内容
独自のレシピをアップロード	TM6 または TM7 用の新しいレシピを、Cookidoo の「My recipes」（Meine Rezepte）に作成します。
Thermomix の設定（ガイド付き調理）	手順に 3 Min./120°C/Stufe 1 のような設定が含まれている場合、実際の Thermomix の設定になります。手順をタップすると、Thermomix が設定されます。時間、温度、Varoma、速度、逆回転（Linkslauf）、低速混合（Sanftrührstufe）に対応しています。
Thermomix のモード	生地こね、ターボ、ブレンド、加熱、炊飯器モードに加え、TM7 ではスチームと焼き色付け（Teig kneten/2 Min., Turbo/1 Sek. …）にも対応しており、Cookidoo からリアルタイムで読み取ります。
材料へのリンク	手順に材料リストと完全に同じ表記の材料行が含まれている場合、Cookidoo エディターで作成したレシピと同様にリンクとして表示されます。
アップロード前の確認	レシピを検証し、検出された設定、モード、材料リンクを表示します。適合しない項目がある場合は、その理由も明確に示します。
アップロード済みレシピの修正	すでにアップロードしたレシピの手順を置き換えます。たとえば、後から Thermomix の設定を追加できます。材料、時間、ヒントは変更されません。

レシピを探して、計画し、買い物する

機能	内容
レシピを探す	Cookidoo のカタログを検索し（除外する材料、最大調理時間、デバイスなどで絞り込み可能）、自分のレシピも一覧表示します。
レシピを見る	カタログのレシピや自分のレシピの材料、手順、時間を表示します。
1 週間の計画を立てる	Cookidoo の週間プラン（Meine Woche）を表示し、カタログのレシピや自分のレシピを特定の日に追加したり、削除したりします。
買い物リスト	レシピの材料を Cookidoo の買い物リストに追加します。

セットアップ

Cookidoo アカウント（独自のレシピを作成するには有効なサブスクリプションが必要です）と、 Python とサーバーをインストールする uv が必要です。 このプロジェクトをダウンロードする必要はありません。

Claude Desktop

Settings → Developer → Edit Config を開き、サーバーを claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "cookidoo": {
      "command": "uvx",
      "args": ["mcp-cookidoo"],
      "env": {
        "COOKIDOO_EMAIL": "[email protected]",
        "COOKIDOO_PASSWORD": "your-password-here"
      }
    }
  }
}

Claude Desktop を再起動します。Cookidoo のツールがツール一覧に表示されます。

Claude Code

claude mcp add cookidoo -e [email protected] -e COOKIDOO_PASSWORD=your-password-here -- uvx mcp-cookidoo

その他の国

サーバーはデフォルトでドイツの Cookidoo を使用します。別の国で使用する場合は、たとえば "COOKIDOO_COUNTRY": "fr" と "COOKIDOO_LANGUAGE": "fr-FR" を env に追加します。手順内の Thermomix の設定は常にドイツ語表記で記述します（下記参照）。

ソースチェックアウトから実行

開発時、または 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 .env

MCP クライアントでは、uvx の代わりにコマンド /path/to/mcp-cookidoo/venv/bin/mcp-cookidoo（Windows： C:\\path\\to\\mcp-cookidoo\\venv\\Scripts\\mcp-cookidoo.exe）を使用します。.env ファイルは コンピューター上に残り、git の対象から除外されます。プロジェクトフォルダーで fastmcp run server.py を実行しても サーバーを起動できます。

使い方

以下のプロンプト例をアシスタントにコピーし、最初の行にある料理名を置き換えてください。このプロンプトには、 Thermomix の設定と材料リンクを正しく処理するためにアシスタントが必要とする情報がすべて含まれています。 どの言語で書いてもかまいません。最後のルールによってレシピの言語が決まります。

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.

アシスタントは、次のツールを順番に使用します。

1. connect_to_cookidoo でサインインします。
2. get_thermomix_modes で、デバイスに対応する Cookidoo のモードとその記述方法を一覧表示します。
3. generate_recipe_structure でレシピを確認し、検出された設定、モード、リンクを報告します。
4. upload_custom_recipe でレシピをアカウントに保存し、レシピ ID とリンクを返します。

1 週間の計画を立てる

アシスタントにレシピを探して計画を立てるよう依頼することもできます。たとえば：

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.

アシスタントは、レシピを探すために search_recipes と list_my_recipes を使用し、レシピの内容を見るために get_recipe_details を使用します。また、計画と買い物には plan_recipe、get_week_plan、 add_to_shopping_list を使用します。

すべてのツール

ツール	目的
connect_to_cookidoo	サインインします。最初に呼び出してください。
get_thermomix_modes(device="TM6")	Cookidoo が現在 TM6 または TM7 向けに提供しているモードを、表記と指定可能な値とともに一覧表示します。
search_recipes(query, ingredients, exclude_ingredients, max_total_time, difficulty, portions, device, limit, page)	Cookidoo のカタログを検索します。すべてのフィルターは任意です。Cookidoo は1ページあたり最大20件の結果を返します。
list_my_recipes()	ID、デバイス、時間とともに、自分のレシピを一覧表示します。
get_recipe_details(recipe_id)	カタログのレシピ（r59322）または自分のレシピ（01M5…）の材料、手順、時間を表示します。自分のレシピの手順は、update_custom_recipe_steps が受け付ける表記で表示されます。
get_week_plan(day="")	day から始まる週（YYYY-MM-DD、既定値は今日）に予定されているレシピを表示します。
plan_recipe(day, recipe_ids)	1日分の予定に、1つ以上のレシピ（カンマ区切り。カタログのレシピと自分のレシピを混在可能）を追加します。
unplan_recipe(day, recipe_id)	週間プランの1日分からレシピを削除します。
add_to_shopping_list(recipe_ids)	レシピの材料を Cookidoo の買い物リストに追加します。
generate_recipe_structure(name, ingredients, steps, servings, prep_time, total_time, hints, device="TM6")	レシピを検証し、検出された設定、モード、リンクをプレビューします。
upload_custom_recipe(recipe_json)	Cookidoo にレシピを作成します（generate_recipe_structure の JSON を渡します）。
update_custom_recipe_steps(recipe_id, steps, ingredients="")	自分のレシピの手順をすべて置き換えます。デバイスはレシピから取得されます。ingredients を指定しない場合、現在の材料リストが Cookidoo から読み込まれます。

チェックを動作させるために get_thermomix_modes を呼び出す必要はありません。検証、アップロード、更新では、手順を作成する前に常に Cookidoo からモードを読み込みます。接続がない場合、generate_recipe_structure は組み込みリストを使用し、その旨を示します。

材料、手順、ヒントは1行に1つずつ渡します。手順の先頭にある 1. や - などのリストマーカーは削除されます。

Thermomix の設定の記述

設定は Cookidoo の表示と同じように、時間/温度/速度 の形式で手順のテキストに記述します。

手順内の表記	意味
4 Sek./Stufe 5	4秒、速度5
3 Min./120°C/Stufe 1	3分、120 °C、速度1
1 Min. 30 Sek./90°C/Stufe 2	1分30秒、90 °C、速度2
15 Min./100°C/Linkslauf/Stufe 1	逆回転（反時計回り）
12 Min./100°C/Linkslauf/Sanftrührstufe	逆回転でソフト撹拌（Stufe Sanftrühren も使用できます）
20 Min./Varoma/Stufe 1	Varoma 温度（TM6 のみ）
10 Sek./Stufe 0,5	速度0.5

手順の例：

1 Zwiebel in den Mixtopf geben und 5 Sek./Stufe 5 zerkleinern.

ルール（Cookidoo エディターで適用されるものと同じです）：

• 速度は 0.5〜10 の0.5刻み、およびソフト撹拌が有効です。温度は省略可能で、37〜120 °C の Thermomix の設定値のいずれかを指定します（37、40、45 … 95、98、100、105、110、115、120）。
• 加熱中の速度は最大 6 です。
• 時間は、5分までは10秒刻み、20分までは30秒刻み、それ以降は1分刻みで、最大99分です。それ以外の時間も使用されますが、ツールの出力で警告されます。
• レシピの他の部分が何語であっても、表記にはドイツ語（Min.、Sek.、Stufe、Linkslauf）を使用します。
• 無効な値（例：Stufe 12 や 42°C）はプレーンテキストのまま残り、ツールの出力に理由が表示されます。
• 未対応： 華氏。

Thermomix モード

Cookidoo に表示されるモード名を書き、その後に / で区切って値を記載します。

手順内の表記	モード	デバイス	許可される値
Teig kneten/2 Min.	生地をこねる（Teigstufe、Teigmodus とも）	TM6, TM7	1 秒～20 分
Turbo/1 Sek.	ターボ	TM6, TM7	0.5 秒、1 秒、または 2 秒
Turbo/1 Sek./3x	パルス運転のターボ	TM7	1～9 回のパルス
Pürieren/1 Min./Stufe 8	ブレンド	TM6, TM7	10 秒～5 分、スピード 6～8
Erwärmen/65°C/Stufe 1	温める	TM6, TM7	37～90 °C、ソフト撹拌（デフォルト）、スピード 1 または 2
[Reis kochen]	ライスクッカー	TM6, TM7	なし（角括弧はモードであることを示します）
Dampfgaren/20 Min./Stufe 1/im Varoma	蒸す	TM7	最大 99 分、ソフト撹拌～スピード 5、任意で Linkslauf、im Varoma（デフォルト）、im Gareinsatz、または in beidem
Anbraten/10 Min./160°C/Leicht	焼き色をつける	TM7	140～160 °C、最大 30 分（デフォルトは 10 分）、Leicht（デフォルト）または Intensiv

レシピでは、Cookidoo と同じ形式（名前、モードアイコン、時間。たとえば、生地アイコンと「2 Min.」が付いた「Teig kneten」）で手順にモードが表示され、それをタップすると Thermomix でモードが開始します。

上記の一覧は 2026 年 10 月時点のものです。サーバーは Cookidoo から最新の一覧（get_thermomix_modes）を読み込みます。Cookidoo が提供を終了したモードは使用されなくなり、新しいモードは、サーバーが値を把握するまで「未対応」として表示されます。

材料のリンク

材料リストの項目が手順内に一字一句同じ形で記載されている場合、その材料はリンクされています。

材料リスト	手順	リンク済み？
1 Zwiebel	1 Zwiebel und 1 Knoblauchzehe in den Mixtopf geben	はい
1 Zwiebel	Die Zwiebel in den Mixtopf geben	いいえ

短い材料の項目（1 Zwiebel, halbiert ではなく 1 Zwiebel）にすると、手順が読みやすくなります。 ツールの出力には、リンク済みの材料と未リンクの材料が一覧表示されます。

Cookidoo のエディターと同様に、サーバーは材料と手順に含まれる ; を全角セミコロン（；）に置き換えます。

アップロード済みレシピの修正

設定を忘れた場合やリンクが欠けている場合は、レシピ ID（アップロード結果、または Cookidoo 上のレシピ URL から取得）と、新しい手順の完全な一覧を update_custom_recipe_steps に渡してください。すべての手順を置き換え、それ以外は変更しません。

開発

コードは mcp_cookidoo パッケージにあります。ソースのチェックアウト（上記を参照）で、設定、モード、リンク、レシピヘルパーのテストを実行するには、次のコマンドを使用します。

pytest

fixtures/ 内のファイルは、Cookidoo エディターの設定ダイアログ（TM6 と TM7）と、エディター自体が生成した手順です。テストでは、サーバーがまったく同じものを生成するか確認します。

フォーマットと lint を実行します。

black .
ruff check .

リリース

1. pyproject.toml、mcp_cookidoo/__init__.py、fastmcp.json、および server.json 内の 2 か所に新しいバージョンを設定します。
2. コミットしてから、タグを付けてプッシュします。git tag v1.0.1 && git push origin v1.0.1。

GitHub Actions のワークフロー publish.yml はテストを実行し、パッケージを PyPI に、サーバーを MCP Registry に公開します。

謝辞

このプロジェクトは、サーバーの初版（ログイン、レシピ構造、アップロード）を構築した Alexandre Patelli による alexandrepa/mcp-cookidoo のフォークとして始まりました。ありがとうございます！

本プロジェクトは、Cookidoo プラットフォームへの Python インターフェースを提供する cookidoo-api を基盤にしています。この連携を実現してくださったことに、心より感謝します！

ライセンス

MIT。詳細は LICENSE を参照してください。