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=user@example.com
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#

CommandDescriptionloginTest credentials, show user infouser-infoGet account infosubscriptionCheck active subscription statusrecipe <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 calendarshopping-listShow full shopping list (ingredients + additional items)shopping-add <id> [...]Add recipe ingredients to shopping listshopping-remove <id> [...]Remove recipe ingredients from shopping listshopping-clearClear entire shopping listadditional-itemsList additional (manual) shopping itemsadditional-add <item> [...]Add manual items to shopping listadditional-remove <id> [...]Remove additional items by IDcollectionsList custom and managed collectionscollection-add <name>Create custom collectioncollection-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