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

The **Cookidoo** {% term integration %} allows you to interact with your shopping lists of [Cookidoo the official Thermomix recipe platform](https://cookidoo.international/) 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" %}

```yaml
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 %}