Cookidoo / tmx-cli Skill

Manage Cookidoo® (Thermomix) meal plans, recipes, and shopping lists using tmx-cli — a pure-Python CLI bundled in this skill at {baseDir}/tmx_cli.py.

Setup

1. Python 3.9+ required (no external dependencies)
2. Login: python3 {baseDir}/tmx_cli.py login (OAuth flow with Cookidoo account)
3. Setup (optional): python3 {baseDir}/tmx_cli.py setup — configure TM version, diet preferences, max cooking time

Critical Rules

1. Confirm before destructive actions (shopping clear, plan remove).
2. Use --json when parsing output programmatically.
3. Respect user preferences — setup config auto-applies to searches.

CLI Usage

python3 {baseDir}/../tmx-cli/tmx_cli.py <resource> <action> [options]

Core Workflows

Search Recipes

tmx search "Pasta" --json
tmx search "Kuchen" -n 20 --json              # more results
tmx search "Suppe" -t 30 --json               # max 30 min prep time
tmx search "Salat" -d easy -c vegetarisch --json  # easy + vegetarian

Filters: -t <minutes>, -d easy|medium|advanced, --tm TM5|TM6|TM7, -c <category>

Categories: vorspeisen, suppen, pasta, fleisch, fisch, vegetarisch, beilagen, desserts, herzhaft-backen, kuchen, brot, getraenke, grundrezepte, saucen, snacks

Recipe Details

tmx recipe show <recipe_id> --json   # ingredients, steps, nutrition

Meal Plan

tmx plan show --json                 # current week plan
tmx plan sync                        # sync from Cookidoo
tmx plan add <recipe_id> <day>       # add recipe (day: mon/tue/wed/thu/fri/sat/sun)
tmx plan remove <recipe_id> <day>    # remove from plan
tmx plan move <recipe_id> <from> <to>  # move between days

Shopping List

tmx shopping show --json             # current list
tmx shopping from-plan               # generate from meal plan
tmx shopping add <recipe_id>         # add recipe ingredients
tmx shopping add-item "Milch" "1L"   # add custom item
tmx shopping remove <recipe_id>      # remove recipe ingredients
tmx shopping clear                   # clear entire list ⚠️
tmx shopping export                  # export as markdown
tmx shopping export --format json    # export as JSON

Today's Recipes

tmx today --json                     # what's on the plan today

Favorites

tmx favorites show --json
tmx favorites add <recipe_id>
tmx favorites remove <recipe_id>

Full Command Reference

For all commands, options, and flags see {baseDir}/references/commands.md.