Todoist Projects

Blocks for creating and managing projects in Todoist.

Todoist Create Project

What it is

Creates a new project in Todoist

How it works

Takes project details and creates via Todoist API.

Inputs

Input	Description	Type	Required
name	Name of the project	str	Yes
parent_id	Parent project ID	str	No
color	Color of the project icon	"berry_red" | "red" | "orange" | "yellow" | "olive_green" | "lime_green" | "green" | "mint_green" | "teal" | "sky_blue" | "light_blue" | "blue" | "grape" | "violet" | "lavender" | "magenta" | "salmon" | "charcoal" | "grey" | "taupe"	No
is_favorite	Whether the project is a favorite	bool	No
view_style	Display style (list or board)	str	No

Outputs

Output	Description	Type
error	Error message if the operation failed	str
success	Whether the creation was successful	bool

Possible use case

Creating new projects programmatically for workflow automation.

---

Todoist Delete Project

What it is

Deletes a Todoist project and all its contents

How it works

Uses project ID to delete via Todoist API.

Inputs

Input	Description	Type	Required
project_id	ID of project to delete	str	Yes

Outputs

Output	Description	Type
error	Error message if the operation failed	str
success	Whether the deletion was successful	bool

Possible use case

Removing completed or obsolete projects.

---

Todoist Get Project

What it is

Gets details for a specific Todoist project

How it works

Uses project ID to retrieve details via Todoist API.

Inputs

Input	Description	Type	Required
project_id	ID of the project to get details for	str	Yes

Outputs

Output	Description	Type
error	Error message if the operation failed	str
project_id	ID of project	str
project_name	Name of project	str
project_url	URL of project	str
complete_data	Complete project data including all fields	Dict[str, Any]

Possible use case

Looking up project details for verification or editing.

---

Todoist List Collaborators

What it is

Gets all collaborators for a specific Todoist project

How it works

Uses project ID to get collaborator list via Todoist API.

Inputs

Input	Description	Type	Required
project_id	ID of the project to get collaborators for	str	Yes

Outputs

Output	Description	Type
error	Error message if the operation failed	str
collaborator_ids	List of collaborator IDs	List[str]
collaborator_names	List of collaborator names	List[str]
collaborator_emails	List of collaborator email addresses	List[str]
complete_data	Complete collaborator data including all fields	List[Dict[str, Any]]

Possible use case

Managing project sharing and collaboration.

---

Todoist List Projects

What it is

Gets all projects and their details from Todoist

How it works

Connects to Todoist API using provided credentials and retrieves all projects.

Outputs

Output	Description	Type
error	Error message if the operation failed	str
names_list	List of project names	List[str]
ids_list	List of project IDs	List[str]
url_list	List of project URLs	List[str]
complete_data	Complete project data including all fields	List[Dict[str, Any]]

Possible use case

Getting an overview of all projects for organization or automation.

---

Todoist Update Project

What it is

Updates an existing project in Todoist

How it works

Takes project ID and updated fields, applies via Todoist API.

Inputs

Input	Description	Type	Required
project_id	ID of project to update	str	Yes
name	New name for the project	str	No
color	New color for the project icon	"berry_red" | "red" | "orange" | "yellow" | "olive_green" | "lime_green" | "green" | "mint_green" | "teal" | "sky_blue" | "light_blue" | "blue" | "grape" | "violet" | "lavender" | "magenta" | "salmon" | "charcoal" | "grey" | "taupe"	No
is_favorite	Whether the project should be a favorite	bool	No
view_style	Display style (list or board)	str	No

Outputs

Output	Description	Type
error	Error message if the operation failed	str
success	Whether the update was successful	bool

Possible use case

Modifying project settings or reorganizing projects.

---