🍳 Your Thermomix®/Cookidoo® in the terminal — meal plans, recipes, shopping lists
Quick Start • Features • Demo • Installation • Usage
What is this?
tmx-cli brings Cookidoo® to your terminal. No more browser hassle — manage your weekly meal plan, search 24,000+ recipes, and generate shopping lists directly from the command line.
⚠️ Disclaimer: This is a hobby project for personal use. Not officially affiliated with or endorsed by Vorwerk/Cookidoo®.
It's fast (no slow web apps), hackable (pipe recipes into other tools, automate your meal prep), and runs anywhere with zero dependencies — just pure Python standard library.
🚀 Quick Start
# With uvx (recommended) — runs instantly without installation uvx --from git+https://github.com/Lars147/tmx-cli tmx login # Log in, then get started! uvx --from git+https://github.com/Lars147/tmx-cli tmx search "Pasta"
✨ Features
| Feature | Description |
|---|---|
| 🎯 Setup | Interactive onboarding — configure TM version, diet preferences, max cooking time |
| 🔐 Login | Secure OAuth authentication with your Cookidoo account |
| 📅 Meal Plan | View, sync, add/move recipes |
| 🔍 Search | Browse 24,000+ recipes with filters (time, difficulty, category) — auto-applies your config preferences |
| ❤️ Favorites | Manage your favorite recipes |
| 📖 Recipe Details | Ingredients, steps, nutrition — all in the terminal |
| 🛒 Shopping List | Auto-generate, export (Markdown/JSON) |
| ⚡ Shell Completion | Tab completion for Bash, Zsh, Fish |
| 📦 Zero Deps | Python standard library only, no dependencies |
| 🤖 AI-Agent Friendly | Perfect for Claude, Codex, OpenClaw & other AI assistants |
Works great with AI Agents
The CLI approach makes tmx-cli ideal for AI coding assistants like Claude Code, Codex, or OpenClaw. Text-based, structured commands and parseable output mean AI agents can easily manage your meal planning for you — "add a vegetarian recipe to Thursday" just works.
🎬 Demo
View meal plan
$ tmx plan show
╔══════════════════════════════════════════════════════════╗
║ 🍳 COOKIDOO WOCHENPLAN ║
╠══════════════════════════════════════════════════════════╣
║ Stand: 2026-02-03 19:39 UTC ║
║ Ab: 2026-02-08 ║
╚══════════════════════════════════════════════════════════╝
Sonntag 8. (2026-02-08)
• Auberginen-Pasta [r292049]
• Cremekartoffeln mit Spinat [r45808]
Montag 9. (2026-02-09)
(keine Rezepte)
Search recipes
$ tmx search "Pasta" -n 3
🔍 Suche in Cookidoo: 'Pasta'
──────────────────────────────────────────────────
Gefunden: 24044 Rezepte (zeige 3)
1. Tomaten-Knoblauch-Pasta
⏱ 30 Min ⭐ 4.1
https://cookidoo.de/recipes/recipe/de-DE/r130616
2. Garnelen-Pasta mit Pesto-Sauce
⏱ 25 Min ⭐ 4.8
https://cookidoo.de/recipes/recipe/de-DE/r792997
3. Curry-Nudeln mit gebratenem Schweinefilet
⏱ 45 Min ⭐ 4.6
https://cookidoo.de/recipes/recipe/de-DE/r447830
Get recipe details
$ tmx recipe r130616
╔══════════════════════════════════════════════════════════╗
║ Tomaten-Knoblauch-Pasta ║
╠══════════════════════════════════════════════════════════╣
║ 📊 Einfach │ ⏱ 30 Min │ 🍽 3 Portionen ║
╚══════════════════════════════════════════════════════════╝
🔗 https://cookidoo.de/recipes/recipe/de-DE/r130616
📝 ZUTATEN
────────────────────────────────────────
• 50 g Parmesan (in Stücken)
• 1 rote Chilischote, getrocknet
• 4 Knoblauchzehen
• 1 Zwiebel (halbiert)
• 30 g Öl
• 1 Bund Basilikum (ohne Stiele)
• 550 g Wasser
• 400 g Cherry-Tomaten (halbiert oder geviertelt)
• 20 g Tomatenmark
• 1 TL Salz
• 340 g Tagliatelle
👨🍳 ZUBEREITUNG
────────────────────────────────────────
1. Parmesan in den Mixtopf geben, 10 Sek./Stufe 8
zerkleinern und umfüllen.
2. Chili, Knoblauch und Zwiebeln in den Mixtopf geben, 4
Sek./Stufe 7 zerkleinern und mit dem Spatel nach unten
schieben.
...
Generate shopping list
$ tmx shopping show
🛒 Einkaufsliste
──────────────────────────────────────────────────
📖 Rezepte (5):
• Auberginen-Pasta [r292049]
• Butter-Paneer-Masala [r762577]
• Tofu-Curry mit Gemüse [r821223]
• Pilzragout mit Spätzle [r784889]
• Halloumi-Wraps [r823455]
🥕 Zutaten (70):
[ ] 2 Auberginen
[ ] 4.5 TL Salz
[ ] 8 Prisen Pfeffer
[ ] 3 EL Olivenöl
[ ] 400 g Muschelnudeln
[ ] 800 g Cherry-Tomaten, aus der Dose
...
📦 Installation
Option 1: uvx (recommended)
# Run directly — no installation needed uvx --from git+https://github.com/Lars147/tmx-cli tmx --help # Or install globally uv tool install git+https://github.com/Lars147/tmx-cli tmx --help # Update to latest version uv tool install --upgrade git+https://github.com/Lars147/tmx-cli
Option 2: pipx
pipx install git+https://github.com/Lars147/tmx-cli
tmx --help
# Update
pipx install --force git+https://github.com/Lars147/tmx-cliOption 3: Clone the repo
git clone https://github.com/Lars147/tmx-cli.git
cd tmx-cli
python3 tmx_cli.py --help📖 Usage
🎯 Setup & Configuration
tmx setup # Interactive onboarding # → TM version (TM5/TM6/TM7) # → Diet preferences (vegetarian, vegan, etc.) # → Max cooking time # Searches automatically use these preferences!
🔐 Authentication
tmx login # Interactive login tmx login --email user@example.com --password secret # With credentials tmx status # Check login status
📅 Meal Plan
tmx plan show # Show plan (from cache) tmx plan sync # Sync from Cookidoo tmx plan sync --days 7 # Only next 7 days tmx plan sync --since 2026-02-01 # From specific date tmx today # Today's recipes only # Manage recipes tmx plan add r130616 --date 2026-02-10 # Add tmx plan remove r130616 --date 2026-02-10 # Remove tmx plan move r130616 --from 2026-02-10 --to 2026-02-15 # Move
🔍 Search
tmx search "Pasta" # Simple search tmx search "Curry" -n 20 # More results tmx search "Salat" --time 15 # Max 15 minutes tmx search "Kuchen" --difficulty easy # Easy recipes only tmx search "Suppe" --tm TM6 # TM6 recipes only tmx search "" --category vegetarisch # Browse by category tmx search "Pasta" -t 30 -d easy # Combine filters # 💡 Pro tip: Run `tmx setup` once — searches will auto-apply your # TM version, diet preferences, and max time filters!
📂 Categories
tmx categories # List all categories tmx categories sync # Fetch current from Cookidoo
📖 Recipe Details
tmx recipe r130616 # Ingredients, steps, nutrition tmx recipe show r130616 # Same — detailed view with nutrition info
❤️ Favorites
tmx favorites # Show all favorites tmx favorites add r130616 # Add to favorites tmx favorites remove r130616 # Remove from favorites
🛒 Shopping List
# View tmx shopping show # Aggregated list tmx shopping show --by-recipe # Grouped by recipe # Manage tmx shopping add r130616 # Add recipe tmx shopping add-item "Milk" "Bread" # Add custom items tmx shopping from-plan # All recipes from plan (7 days) tmx shopping from-plan -d 14 # Next 14 days tmx shopping remove r130616 # Remove recipe tmx shopping clear # Clear list # Export tmx shopping export # Text to stdout tmx shopping export -f markdown # Markdown with checkboxes tmx shopping export -f markdown -r # Grouped by recipe tmx shopping export -f json -o list.json # JSON to file
🗑️ Cache
tmx cache clear # Clear cache tmx cache clear --all # Also session (requires re-login)
⚡ Shell Completion
# Bash (add to ~/.bashrc) eval "$(tmx completion bash)" # Zsh (add to ~/.zshrc) eval "$(tmx completion zsh)" # Fish (run once) tmx completion fish > ~/.config/fish/completions/tmx.fish
🔧 How It Works
| Component | Technology |
|---|---|
| Authentication | Vorwerk/Cidaas OAuth Flow |
| Meal Plan | Cookidoo Calendar API |
| Recipe Search | Algolia (same as Cookidoo website) |
| Storage | Local JSON files |
Files
~/.tmx-cli/
├── cookidoo_cookies.json # Session
├── cookidoo_search_token.json # Search token
├── cookidoo_weekplan_raw.json # Cached plan
└── cookidoo_categories.json # Categories
🤝 Contributing
Contributions are welcome!
- Fork the repo
- Create a feature branch (
git checkout -b feature/awesome) - Commit your changes (
git commit -m 'Add awesome feature') - Push to the branch (
git push origin feature/awesome) - Open a Pull Request
Ideas & TODOs
- Collections support
- Meal plan templates
- Nutrition summary
- Recipe export (Markdown/PDF)
⚠️ Disclaimer
This is an unofficial tool. Cookidoo® and Thermomix® are registered trademarks of the Vorwerk Group.
This project is not affiliated with, endorsed, or sponsored by Vorwerk. Please respect Cookidoo's terms of service.
📄 License
MIT © Lars Heinen
Made with ❤️ for Thermomix nerds who live in the terminal