Project ( Optional): The project to put the task in. Here are two example JSON payloads resulting in the same task:Ĭontent ( Required): The name of the task you want to create. You can specify labels and a project, or you can leave them blank, and the task will go to your “Inbox” project. This service can be used to create a new Todoist task. Todoist also comes with access to a service, todoist.new_task. Overdue: Whether the reported task is past its due date.ĭue_today: Whether the reported task is due today. Task_labels: All labels associated with this task. Task_comments: Any comments added to this task.

Note that this is the opposite of how things are displayed in the Todoist app! 1 means lowest priority, 4 means highest. Priority: The priority Todoist reports this task as having. Usually within the last 15 minutes.Īll_tasks: A list of all tasks in this project, sorted from most important to least important. Start_time: The last time the Todoist integration got updated. Message: The title of the “most important” task coming up in this project.ĭescription: A URL pointing to the task on the Todoist website. Sensor attributesĪll_day: True if the reported task doesn’t have a due date. You can access the other tasks you have due soon via the all_tasks array (see below).

Home Assistant does its best to determine what task in each project is “most” important, and it’s that task which has its state reported. You can even use IFTTT to create a task with a certain label, then have Home Assistant do some kind of automation when a task with that label comes due. You can mix-and-match these attributes to create all sorts of custom projects.

# Example configuration.yaml entry calendar : - platform : todoist token : YOUR_API_TOKEN custom_projects : - name : ' All Projects' - name : ' Due Today' due_date_days : 0 - name : ' Due This Week' due_date_days : 7 - name : ' Math Homework' labels : - Homework include_projects : - Mathematical Structures II - Calculus IIĪs you can see, there are 4 custom projects here:Ī project containing all of the tasks on this account.Ī project containing all the tasks on this account that are due today.Ī project containing all the tasks on this account due within the next week.Ī project containing everything with the label “Homework”, taking only 2 projects into account.

To do ist