Notifications & Sensors

Notifications

IntelliKeep reminds you as tasks approach their due date, and again once they are overdue.

How notifications work

• Checks run once an hour
• A reminder goes out when a task is within its Remind me window: N days before the due date, set per task (new tasks start with the default from the integration options)
• An overdue task gets its own notification, unless Notify when overdue is off for it
• Each task is notified once per stage and due date. What was sent is saved, so restarting Home Assistant doesn't send the same reminders again, and a task whose due date changes gets a reminder for the new date
• Completing or deleting a task clears its notification state
• Notifications are written in Home Assistant's language, set under Settings → System → Home information (General in older versions): English, Portuguese or Spanish, and English for any other language

Notification channels

Channel	Always active	How to configure
Home Assistant persistent notifications	Yes	Built in, no configuration needed
Mobile push (or any notify.* service)	Optional	Set a notification service in Configuration

Notification event

Every notification also fires an intellikeep_task_notification event that you can use in automations:

triggers:
  - trigger: event
    event_type: intellikeep_task_notification
    event_data:
      event_type: overdue   # or "approaching"

Field	Description
event_type	approaching or overdue
task_id	ID of the task
title	Notification title, in Home Assistant's language
message	Notification message, in Home Assistant's language
notification_id	ID of the persistent notification

Task update event

IntelliKeep also fires intellikeep_task_updated whenever a task changes, with the fields task_id and action. The action is one of created, updated, completed, reopened, deleted, note_added or note_deleted.

triggers:
  - trigger: event
    event_type: intellikeep_task_updated
    event_data:
      action: completed

See Automations for complete examples.

Sensor entities

IntelliKeep creates three sensors that you can use in dashboards and automations:

Entity	State	Attributes
sensor.intellikeep_tasks_due_today	Number of open tasks due today or already overdue	—
sensor.intellikeep_tasks_overdue	Number of overdue tasks	overdue_tasks: list with the task_id, name, due_date and priority of each overdue task
sensor.intellikeep_next_due_task	Name of the open task with the nearest due date	task_id, due_date, priority, linked_entity_ids, frequency, repeat_interval, weekdays

The entity IDs assume the default instance name; see Entity IDs.

IntelliKeep also has a to-do list and a calendar entity.

Data updates

Task state is refreshed:

• Right after any change made from the panel, the card, the to-do list or an action
• Every 5 minutes, so the counts follow the clock (a task becomes due or overdue at local midnight)
• The panel and the card receive updates as soon as the data changes, without reloading the page