Todoist

Connect your Todoist data to Airweave

Overview

The Todoist connector allows you to sync data from Todoist into Airweave, making it available for search and retrieval by your agents.

Todoist source implementation.

This connector retrieves hierarchical data from the Todoist REST API:

The Todoist entity schemas are defined in entities/todoist.py.

Explore the Todoist connector implementation

This connector uses OAuth 2.0 authentication flow.

Authentication Configuration

Todoist authentication credentials schema.

access_token

strRequired

The access token for your Todoist app.

The following data models are available for this connector:

Schema for Todoist project entities.

Field	Type	Description
name	str	The name of the project
color	Optional[str]	Color of the project (e.g., ‘grey’, ‘blue’)
comment_count	int	Number of comments in the project
order	int	Project order in the project list
is_shared	bool	Whether the project is shared with others
is_favorite	bool	Whether the project is marked as a favorite
is_inbox_project	bool	Whether this is the Inbox project
is_team_inbox	bool	Whether this is the team Inbox project
view_style	Optional[str]	Project view style (‘list’ or ‘board’)
url	Optional[str]	URL to access the project
parent_id	Optional[str]	ID of the parent project if nested

Schema for Todoist section entities.

Field	Type	Description
name	str	The name of the section
project_id	str	ID of the project this section belongs to
order	int	Section order in the project

Schema for Todoist task entities.

Field	Type	Description
content	str	The task content/title
description	Optional[str]	Optional detailed description of the task
comment_count	int	Number of comments on the task
is_completed	bool	Whether the task is completed
labels	List[str]	List of label names attached to the task
order	int	Task order in the project or section
priority	int	Task priority (1-4, 4 is highest)
project_id	Optional[str]	ID of the project this task belongs to
section_id	Optional[str]	ID of the section this task belongs to
parent_id	Optional[str]	ID of the parent task if subtask
creator_id	Optional[str]	ID of the user who created the task
created_at	Optional[datetime]	When the task was created
assignee_id	Optional[str]	ID of the user assigned to the task
assigner_id	Optional[str]	ID of the user who assigned the task
due_date	Optional[str]	Due date in YYYY-MM-DD format
due_datetime	Optional[datetime]	Due date and time
due_string	Optional[str]	Original due date string (e.g., ‘tomorrow’)
due_is_recurring	bool	Whether the task is recurring
due_timezone	Optional[str]	Timezone for the due date
deadline_date	Optional[str]	Deadline date in YYYY-MM-DD format
duration_amount	Optional[int]	Duration amount
duration_unit	Optional[str]	Duration unit (‘minute’ or ‘day’)
url	Optional[str]	URL to access the task

Schema for Todoist comment entities.

Field	Type	Description
task_id	str	ID of the task this comment belongs to
content	Optional[str]	The comment content
posted_at	datetime	When the comment was posted