Recurring Reminders

Integration to manage recurring reminders and tasks in Home Assistant.

This integration will set up the following platforms.

Platform	Description
number	Editable interval and countdown for recurring reminders.

Features

• Configurable Reminders: Create reminders with custom intervals (in days)
• Two Sensors per Reminder:
  • Interval Sensor: Shows the configured interval in days
  • Countdown Sensor: Counts down the days until the next reminder
• Direct Editing: Change values directly in Home Assistant UI with sliders or input boxes

Installation

HACS (Recommended)

1. In the HACS GUI, go to "Integrations"
2. Click the three dots in the top right corner and select "Custom repositories"
3. Add this repository URL and select "Integration" as the category
4. Click "Install" on the "Recurring Reminders" integration
5. Restart Home Assistant
6. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Recurring Reminders"

Manual Installation

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml)
2. If you do not have a custom_components directory (folder) there, you need to create it
3. In the custom_components directory (folder) create a new folder called recurring_reminders
4. Download all the files from the custom_components/recurring_reminders/ directory (folder) in this repository
5. Place the files you downloaded in the new directory (folder) you created
6. Restart Home Assistant
7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Recurring Reminders"

Configuration

When adding a new reminder, you will be asked for:

• Reminder Name: e.g., "Vacuum hallway"
• Interval in Days: e.g., 7 for weekly

Usage

Number Entities

For each reminder, two editable number entities are created:

1. number.recurring_reminders_[name]_interval - Set the interval (directly editable)
2. number.recurring_reminders_[name]_countdown - Set remaining days (directly editable)

Editing Values

Simply click on the entity in Home Assistant and change the value:

• Use sliders for quick adjustments
• Use input boxes for precise values
• Changes are applied immediately

Examples:

• Change interval from 7 to 14 days: Click on interval entity → Set to 14
• Reset countdown: Click on countdown entity → Set to same value as interval
• Set custom countdown: Click on countdown entity → Set to desired days

Automations

You can create automations based on the sensors:

automation:
  - alias: "Reminder: Vacuum hallway"
    trigger:
      - platform: state
        entity_id: number.recurring_reminders_vacuum_hallway_countdown
        to: "0"
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Time to vacuum the hallway!"
          title: "Household Reminder"

Example Dashboard Card

type: entities
title: Household Reminders
entities:
  - entity: number.recurring_reminders_vacuum_hallway_countdown
    name: Vacuum hallway
    icon: mdi:vacuum
  - entity: number.recurring_reminders_vacuum_hallway_interval
    name: Vacuum interval
    icon: mdi:calendar-clock
  - entity: number.recurring_reminders_clean_bathroom_countdown
    name: Clean bathroom
    icon: mdi:spray-bottle

How it works

• The countdown is automatically reduced by 1 daily
• When it reaches 0, the value stays at 0
• Simply click on the countdown entity to reset or adjust the value
• Click on the interval entity to change the recurring interval
• All changes are applied immediately through the Home Assistant UI

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

---