home-assistant.io/source/_integrations/cookidoo.markdown

title	description	ha_category	ha_iot_class	ha_release	ha_config_flow	ha_codeowners	ha_domain	ha_integration_type	ha_platforms	related	ha_quality_scale
Cookidoo	Instructions on how to integrate the Cookidoo todo list with Home Assistant.	To-do list	Cloud Polling	2025.1	true	@miaucl	cookidoo	service	button diagnostics sensor todo	docs title /integrations/todo To-do list integration documentation docs title /integrations/#to-do-list List of to-do list integrations docs title /dashboards/todo-list/ To-do list card url title https://cookidoo.international/ Cookidoo the official Thermomix recipe platform url title https://www.vorwerk.com/ Vorwerk GmbH	silver

The Cookidoo {% term integration %} allows you to interact with your shopping lists of Cookidoo the official Thermomix recipe platform within Home Assistant.

{% configuration_basic %} Email: description: "Enter the email address associated with your Cookidoo." Password: description: "Enter the password for your Cookidoo account." Localization: description: "Select the language and country for your Cookidoo account (e.g., English - United States)." {% endconfiguration_basic %}

{% include integrations/config_flow.md %}

To-do lists

This integration provides two non-sortable to-do lists:

1. Shopping list

   • Contains ingredients from recipes
   • Items can only be checked
   • Items cannot be created, deleted, or renamed

2. Additional purchases

   • Contains user-added items to purchase
   • Items can be created, deleted, and updated
   • Items do not have a description field

For example, if you add a pasta recipe, ingredients like "500g pasta" and "2 tomatoes" will appear in your "Shopping list". You can check these items off as you shop, but you cannot modify the label.

In contrast, in your "Additional purchases" list, you can freely add items like "Kitchen towels" or "Dish soap", and modify or remove them as needed.

Button entities

The clear shopping list button entity allows you to clear both the shopping list and additional purchases list, mirroring the functionality available in the Cookidoo app. When triggered, this button will remove all items from both lists.

This button entity will appear automatically in your Home Assistant instance after adding the integration. You can use it in automations or add it to your dashboard using the Button card.

Sensor entities

Diagnostics

1. Subscription

   • State: premium, trial, or free
   • Description: Indicates the current subscription type
     • premium: Yearly subscription with full recipe access
     • trial: Time-limited premium access (available during account creation or new device linking)
     • free: Limited recipe access with full shopping list features

2. Subscription expiration date

   • State: ISO 8601 timestamp or unknown
   • Description: Shows when the current subscription expires
     • For premium and trial subscriptions: Timestamp of expiration date
     • For free subscriptions: Returns unknown state

These sensor entities will appear automatically in your Home Assistant instance after adding the integration.

{% details "Example state attributes" %}

subscription:
  state: premium
  icon: mdi:account-star

subscription_expiration_date:
  state: "2025-01-15T23:59:59+00:00"
  icon: mdi:clock-reactivate

{% enddetails %}

Known Limitations

{% important %} As Cookidoo cannot share shopping lists between accounts and everybody interacting with it uses the same credentials, make sure you protect your credentials accordingly. All users of your Home Assistant instance will have access to the same Cookidoo account. {% endimportant %}

The Home Assistant to-do list interface allows both renaming items and changing their state. However, for the "Shopping list", only state changes (checking/unchecking items) are supported. Any attempts to rename items will not be saved.

Data updates

The Cookidoo integration fetches data from the device every 90 seconds by default.

Remove integration

This integration follows standard integration removal, no extra steps are required.

{% include integrations/remove_device_service.md %}