OpenClaw · Skill

Tmx CLI

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 .

Search & Research

v0.1.0

VirusTotal: Benign

Install

Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.

Primary command

clawhub install lars147/tmx-cli

ClawHub installer

npx clawhub@latest install lars147/tmx-cli

OpenClaw CLI

openclaw skills install lars147/tmx-cli

Direct OpenClaw install

openclaw install lars147/tmx-cli

View source

What this skill does

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 .

Why it matters

Automates the repetitive back-and-forth of opening Cookidoo in a browser to manage plans and lists, keeping everything scriptable and agent-accessible.

Typical use cases

Search Cookidoo recipes by category and prep time
Build a weekly meal plan day by day
Generate a shopping list from the week's planned recipes
Add custom items to the Cookidoo shopping list
Check what recipes are scheduled for today

Source instructions

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

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

Critical Rules

Confirm before destructive actions (shopping clear, plan remove).
Use --json when parsing output programmatically.
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.

Related OpenClaw skills

Browse all →

OpenClaw Skill