Remember The Milk

The Remember The Milk integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] connects your Remember The Milk (RTM) account to Home Assistant. Your RTM lists appear as to-do lists in Home Assistant, so you can manage list items from the To-do list dashboard or the To-do list card and add tasks from automations. The integration supports connecting several Remember The Milk accounts.

Prerequisites

You need a Remember The Milk account, an API key, and a shared secret.

1. Sign in to your Remember The Milk account.
2. Apply for an API key. You also receive a shared secret when the key is approved.

Configuration

To add the Remember The Milk service to your Home Assistant instance, use this My button:

After you enter your API key and shared secret, Home Assistant shows an Authorize link. Select the link to allow Home Assistant to access your Remember The Milk account on the Remember The Milk website. When you have completed the authorization, return to Home Assistant and select Submit to finish the setup.

To connect more than one account, add the integration again for each Remember The Milk account.

To-do lists

Each of your Remember The Milk lists appears in Home Assistant as a to-do list entity. You can view and manage your lists from the To-do list dashboard card.

Your lists stay in sync with your Remember The Milk account in both directions. Creating, renaming, or deleting a list in Home Assistant is reflected in your RTM account, and vice versa. Smart, archived, locked, and deleted lists are not synced.

Each to-do list item supports a summary, an optional due date or due date and time, and an optional description.

Adding a list

1. Go to Settings > Devices & services and select the Remember The Milk integration.
2. Select Add list.
3. Enter a name for the list. A new list with that name is also created in your Remember The Milk account.

Renaming a list

1. Go to Settings > Devices & services and select the Remember The Milk integration.
2. Next to the list you want to rename, select the three dots menu and select Reconfigure.
3. Enter a new name. The list is also renamed in your Remember The Milk account.

Removing a list

Removing a list in Home Assistant also deletes it from your Remember The Milk account.

1. Go to Settings > Devices & services and select the Remember The Milk integration.
2. Next to the list you want to remove, select the three dots menu and select Delete.

List of actions

The Remember The Milk integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

• Complete task (remember_the_milk.my_rtm_username_complete_task) Completes a Remember The Milk task that was created from Home Assistant.

• Create task (remember_the_milk.my_rtm_username_create_task) Creates or updates a task in Remember The Milk.

For an overview of every action across all integrations, see the actions reference.

Automation example

Here’s an example for an automation that creates a new task whenever sensor.mysensor is on and completes it when the sensor reports off. This way it reminds you to switch it off. By using the entity_id as ID for the task, you can use the same rule also for multiple sensors.

alias: "Match fan to ceiling light"
  - triggers:
      - trigger: state
        entity_id: sensor.mysensor
        to: "on"
    actions:
      - action: remember_the_milk.my_rtm_username_create_task
        data:
          name: "Please switch off {{ trigger.entity_id }}"
          id: "{{ trigger.entity_id }}"
  - triggers:
      - trigger: state
        entity_id: sensor.mysensor
        to: "off"
    actions:
      - action: remember_the_milk.my_rtm_username_complete_task
        data:
          id: "{{ trigger.entity_id }}"

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dots menu. Then, select Delete.

Disclaimer

This integration uses the Remember The Milk API but is not endorsed or certified by Remember The Milk.