Cookidoo Thermomix

Interact with Cookidoo (Thermomix recipe platform) via the unofficial cookidoo-api. Search recipes, manage meal planning calendar, shopping lists, collections, and custom recipes. Use when the user mentions "Cookidoo", "Thermomix recipes", "meal planning", "Wochenplan", "Einkaufsliste Thermomix", "Cookidoo Rezepte", "was kochen", or wants to manage their Thermomix/Cookidoo account programmatically.

Cookidoo Integration

Unofficial integration with the Cookidoo platform (Vorwerk/Thermomix) using the cookidoo-api Python library.

Setup

No external dependencies — uses only Python stdlib (urllib, json). Works with Python 3.7+.

Environment variables (required)

text

COOKIDOO_EMAIL=[e-mail]
COOKIDOO_PASSWORD=secret

Optional config

text

COOKIDOO_COUNTRY=ch        # Default: ch (Switzerland)
COOKIDOO_LANGUAGE=de-CH    # Default: de-CH

Supported countries/languages: run get_country_options() / get_language_options() from the library.

CLI Script

All operations via scripts/cookidoo.py:

bash

python scripts/cookidoo.py <command> [args]

Commands

Command	Description
login	Test credentials, show user info
user-info	Get account info
subscription	Check active subscription status
recipe <id>	Get recipe details (e.g. r59322)
calendar [date]	Show meal plan for week (default: today)
calendar-add <date> <id> [...]	Add recipe(s) to calendar (date: YYYY-MM-DD)
calendar-remove <date> <id>	Remove recipe from calendar
shopping-list	Show full shopping list (ingredients + additional items)
shopping-add <id> [...]	Add recipe ingredients to shopping list
shopping-remove <id> [...]	Remove recipe ingredients from shopping list
shopping-clear	Clear entire shopping list
additional-items	List additional (manual) shopping items
additional-add <item> [...]	Add manual items to shopping list
additional-remove <id> [...]	Remove additional items by ID
collections	List custom and managed collections
collection-add <name>	Create custom collection
collection-remove <id>	Delete custom collection

Recipe IDs

Recipe IDs look like r59322 or r907015. Find them on cookidoo.ch/de URLs or via the API.

Authentication

The API uses OAuth password grant (same as the Thermomix app). Tokens refresh automatically per session. No API key needed — just Cookidoo account credentials.

Limitations

• No official API — based on reverse-engineering the Android app
• Recipe search not directly exposed in the library (browse on cookidoo.ch and extract IDs)
• Some features require an active Cookidoo Premium subscription (custom recipes, etc.)
• Rate limiting: be gentle, avoid rapid bulk requests