Services

IntelliKeep provides the Home Assistant actions below. You can call them from automations, scripts, or Settings → Tools → Actions (Developer tools → Actions in older Home Assistant versions). The action editor shows the actions, their fields and their options in the language of your profile (English, Portuguese or Spanish).

Task IDs appear in the attributes of the sensors, in the events and in diagnostics.

intellikeep.create_task

Create a new task.

action: intellikeep.create_task
data:
  name: Replace HVAC filter
  icon: mdi:air-filter
  priority: high
  frequency: monthly
  repeat_interval: 3
  schedule_anchor: due_date
  due_date: "2026-12-01T09:00:00"
  linked_entity_ids:
    - area:living_room          # link to an area
    - device:abc123def456       # or a specific device ID
  notify_days_before: 3
  notify_on_overdue: true

Field	Required	Default	Description
name	Yes	—	Task name
description	No	—	Free-text description
icon	No	mdi:wrench-outline	Icon shown next to the task, e.g. mdi:air-filter
priority	No	medium	low, medium, high or critical
frequency	No	one_time	one_time, daily, weekly, monthly or yearly. For recurring tasks, it is the unit of repeat_interval
repeat_interval	No	1	Repeats every N days, weeks, months or years (1–3650)
schedule_anchor	No	completion	What the next due date is counted from: completion or due_date. See Recurring tasks
weekdays	No	—	For weekly tasks: the days it repeats on, from mon to sun, e.g. [mon, wed, fri]
due_date	No	—	ISO 8601 date and time. Without a UTC offset, it is read in Home Assistant's time zone. Midnight makes the task all day
linked_entity_ids	No	—	Areas (area:<area_id>) and devices (device:<device_id>) to link the task to
notify_days_before	No	Integration default	Days before the due date to send a reminder (0–365)
notify_on_overdue	No	true	Send a notification when the task becomes overdue

Examples

A weekly task on specific days. The next occurrence is always the next selected day, at the same time, so the schedule doesn't drift when a task is completed late:

action: intellikeep.create_task
data:
  name: Take out the garbage
  icon: mdi:trash-can-outline
  frequency: weekly
  weekdays: [mon, wed, fri]
  due_date: "2026-11-09T07:00:00"

A task every 10 days, counted from each completion:

action: intellikeep.create_task
data:
  name: Clean the coffee machine
  frequency: daily
  repeat_interval: 10

:::note Legacy custom frequency frequency: custom with custom_days_interval from versions before 2.0 still works. It is stored as frequency: daily with that repeat_interval. :::

intellikeep.complete_task

Mark a task as done and record a completion. For recurring tasks, the next occurrence is created.

action: intellikeep.complete_task
data:
  task_id: "<task_id>"
  completed_by: "Henrique"
  notes: "Replaced with a MERV-13 filter."

Field	Required	Description
task_id	Yes	ID of the task to complete
completed_by	No	Name of who completed the task, shown in the history
notes	No	Completion notes

intellikeep.reopen_task

Reopen a completed task, setting it back to open. The completion is undone: its record leaves the history, and for a recurring task the next occurrence it created is removed, unless it was already edited, noted or completed.

action: intellikeep.reopen_task
data:
  task_id: "<task_id>"
  performed_by: "Henrique"

Field	Required	Description
task_id	Yes	ID of the task to reopen
performed_by	No	Name of who reopened the task, shown in the activity log

intellikeep.update_task

Update fields of an existing task. Only the fields you send are changed, and the change is recorded in the task's activity log.

action: intellikeep.update_task
data:
  task_id: "<task_id>"
  priority: critical
  due_date: "2026-12-15T09:00:00"
  updated_by: "Henrique"

Accepts the same fields as create_task, plus:

Field	Required	Description
task_id	Yes	ID of the task to update
enabled	No	false closes the task without recording a completion, true opens it again. To complete a task, use complete_task
updated_by	No	Name of who made the change, shown in the activity log

intellikeep.delete_task

Permanently delete a task, with its notes and history.

action: intellikeep.delete_task
data:
  task_id: "<task_id>"

Field	Required	Description
task_id	Yes	ID of the task to delete

intellikeep.add_task_note

Add a timestamped note to a task.

action: intellikeep.add_task_note
data:
  task_id: "<task_id>"
  content: "Noticed some wear on the belt. Check again next month."
  added_by: "Henrique"

Field	Required	Description
task_id	Yes	ID of the task to add the note to
content	Yes	Text of the note
added_by	No	Name of who added the note

intellikeep.delete_task_note

Delete a note from a task.

action: intellikeep.delete_task_note
data:
  task_id: "<task_id>"
  note_id: "<note_id>"

Field	Required	Description
task_id	Yes	ID of the task that owns the note
note_id	Yes	ID of the note to delete

intellikeep.load_sample_data

Add a set of sample home maintenance tasks, with icons. Useful for exploring the panel after a fresh install.

action: intellikeep.load_sample_data

intellikeep.delete_all_data

Permanently delete every task, note and completion record. Only admin users can call this action.

action: intellikeep.delete_all_data

danger

This action can't be undone. All task data is permanently removed.

To-do actions

The to-do list also accepts Home Assistant's todo.* actions, such as todo.add_item, todo.update_item and todo.remove_item, on todo.intellikeep_tasks.