All Collections
Task integrations
Todoist Integration
Overview: Reclaim's integration for Todoist
Overview: Reclaim's integration for Todoist

Use Reclaim's Todoist integration to sync tasks between Todoist and Reclaim.

Updated over a week ago

Reclaim's Todoist integration auto-syncs items created in Todoist to your Google Calendar as smart Tasks via Reclaim, so you actually have time defended to get work done before deadlines.

Requirements for the Todoist integration

  • You must have a Reclaim account with a calendar connected.

  • You must have a Todoist account (compatible with the free Todoist plan).

  • If you're using Todoist's native Google Calendar sync, we recommend disabling it before enabling the Reclaim integration. If you use both the Reclaim integration and Todoist's own Google Calendar integration, you will end up with duplicated events.

Set up the Todoist integration

  1. Navigate to Settings > Integrations in Reclaim.

  2. Click Connect Todoist on the Todoist integration card.

  3. Click Agree to allow Reclaim access to Todoist.

  4. You'll be redirected back to the Todoist integration's settings page in Reclaim.

Syncing your Todoist tasks

When creating new items in Todoist, Reclaim requires two details to get your tasks scheduled with the integration.

Todoist task requirements:

  • Todoist tasks must include a due date unless specified otherwise by you as described here.

  • Tasks in shared projects must be assigned to you.

Note: Reclaim currently does not offer full support for recurring tasks, so if you've set up a recurring task in Todoist it won't sync over to Reclaim.

Without these required fields, Todoist tasks will not be synced via Reclaim, even if they match your sync rules.

For a full overview of how to create and sync items from Todoist to Reclaim, check out this doc.

Creating Todoist sync rules for Reclaim

The Todoist integration settings page allows you to manage how you want Reclaim to schedule your Todoist items.

Reclaim uses simple sync rules to organize which Todoist items you want to sync to your calendar. Each rule is built upon conditions like labels, projects, and scheduling hours.

Todoist sync rules settings

Order

Stack-rank your sync rules to tell Reclaim which rules you want to prioritize if a conflict arises. Drag-and-drop to sort the order.

Label

Select from your labels in Todoist to sync items tagged with that label. Reclaim creates two default labels upon installation of the integration:

  • reclaim : to-dos that schedule during your Working Hours

  • reclaim_personal : to-dos that schedule during your Personal Hours

You can delete these once the integration is installed and/or use your own labels.

Project

Select the Todoist projects you want to sync items from by checking them in the drop down list. You can select all projects, some projects, or no projects.

Project(s) selected

No project(s) selected

Includes label(s)

Sync items in the selected projects also tagged with the set label.

Sync all items tagged with the set label.

No label selected

Sync all items in the selected projects, without a label.

โš ๏ธ Rules must have at least one project and/or label selected to sync items.

Action

  • Sync to: Sync items that meet this rule's conditions.

  • Don't sync: Don't sync items that meet this rule's conditions.

Hours

Set the hours during which you want Reclaim to schedule Todoist items that meet the rule's conditions. You can select from your Working, Personal, or Custom Hours you've created. Learn more about syncing your Todoist items to your different Scheduling Hours in this help doc.

Reclaim will then automatically sync Todoist items to your calendar when they meet the conditions of your rules. Changes to the above integration settings auto-save.

Include Tasks without due dates

The Todoist integration allows you to sync tasks without due dates on a per-rule basis. That means that for some of your rules, you can opt to require due dates, and for others, you can make them optional.

  • If you check Include Tasks without due dates, then any task matching that rule will be synced to Reclaim whether it has a due date or not.

  • If you do not check Include Tasks without due dates, then a due date is required for any task synced from Todoist using that rule.

Sync Todoist tasks to your calendar

Reclaim will automatically sync Todoist items to your calendar when they meet the conditions of your sync rules and include the required fields (due date and you as the assignee).

Changes made to synced Todoist tasks - from both Reclaim or in Todoist - will be automatically updated across both platforms.

How Reclaim prioritizes synced Todoist tasks

Tasks synced via Reclaim's Todoist integration will automatically honor the priority levels in Reclaim to the priority you marked the item as in Todoist.

Priority in Todoist

Priority mapped in Reclaim

Priority 1

Critical (P1)

Priority 2

High priority (P2)

Priority 3

Medium priority (P3)

Priority 4

Low priority (P4)

You can change the priority level of a synced task in Reclaim to adjust how the event is scheduled by Reclaim โ€“ but this will not update the priority in Todoist. If you want to update the priority of a synced task in the platform it was created in, you must do so from the source event in the app.

Learn more about how Reclaim Priorities work in this overview doc.

How Reclaim Tasks displays synced Todoist tasks

When Reclaim syncs a Todoist item, a comment is added with a link to the Reclaim Task and the date/time for the associated calendar event. As time burns down in Reclaim for that Task, the comment text is updated to reflect that progress, as well as to indicate whether the Task is at risk based on the due date you have selected in Todoist.

In Google Calendar and on the Reclaim Planner, the automatically scheduled Task will be named Project: Task title and include a link to the Todoist item in the event description.

Complete and incomplete tasks in Todoist

A Reclaim Task must be marked Done in order for a Todoist task to be marked as complete. Refer to this doc for details on what happens when a task is Marked done.

When rescheduling a Task Event or adding time to a Task Policy, the Todoist task will be automatically un-completed and will show back up in the Todoist project as an incomplete task.

Disconnecting the Todoist integration

To disconnect the Todoist integration from Reclaim, head over to your Todoist integration settings. Scroll to the bottom of the page and select Disconnect.

Did this answer your question?