Remember The Milk

The Remember The Milk integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to create tasks in Remember The Milk (RTM) from Home Assistant. You can use this if you want Home Assistant to send you a task that you should not forget, e.g., water the plants. The integration allows you to have several RTM accounts in parallel.

Setup

The setup consists of two steps: getting an API key and registering your account

Step 1: API key

To be able to use this integration, you need a Remember The Milk account and you need to apply for your own API key. With the API key you will also receive your personal shared secret. Both of them need to be stored in your Home Assistant configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file, restart Home Assistant to apply the changes.

# Example configuration.yaml entry

remember_the_milk:
  - name: your_rtm_username
    api_key: YOUR_API_KEY
    shared_secret: YOUR_SHARED_SECRET

Step 2: Registering your account

After you save the configuration:

1. Restart Home Assistant. When it starts again, you receive a “Configurator” notification in Home Assistant.
2. Select Configure.
3. On the dialog, select Remember The Milk login and log into Remember The Milk website.
4. Select OK, I’ll allow it to authorize Home Assistant to access your Remember The Milk account.
5. Close the RTM browser tab, and back in Home Assistant, select login completed.

This tells Home Assistant that you have completed the login process on the Remember The Milk page and Home Assistant should try to register with this account.

If the registration was successful, the Configurator notification disappears from your Home Assistant notifications.

In the background, Home Assistant downloaded a token from the Remember The Milk server, stored in the remember_the_milk.conf file locally.

Verifying configuration

To confirm that your configuration was successful, go to Settings > Devices & services and select Remember The Milk. The integration should now show 1 entity and if you select it, it should be named after your RTM username.

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 }}"

Disclaimer

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