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)
COOKIDOO_EMAIL=user@example.com
COOKIDOO_PASSWORD=secret
Optional config
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:
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