Skip to main content
Server path: /todoist-projects | Type: Application | PCID required: Yes

Tools

ToolDescription
todoist_projects_archive_project_api_v1_projects_project_id_archive_postArchive Project
todoist_projects_archive_section_api_v1_sections_section_id_archive_postArchive Section
todoist_projects_create_folder_api_v1_folders_postCreate Folder
todoist_projects_create_project_api_v1_projects_postCreate Project
todoist_projects_create_section_api_v1_sections_postCreate Section
todoist_projects_delete_folder_api_v1_folders_folder_id_deleteDelete Folder
todoist_projects_delete_project_api_v1_projects_project_id_deleteDelete Project
todoist_projects_delete_section_api_v1_sections_section_id_deleteDelete Section
todoist_projects_get_activity_logs_api_v1_activities_getGet Activity Logs
todoist_projects_get_api_v1_projects_getGet Projects
todoist_projects_get_archived_api_v1_projects_archived_getGet Archived
todoist_projects_get_folder_api_v1_folders_folder_id_getGet Folder
todoist_projects_get_folders_api_v1_folders_getGet Folders
todoist_projects_get_productivity_stats_api_v1_tasks_completed_stats_getGet Productivity Stats
todoist_projects_get_project_api_v1_projects_project_id_getGet Project
todoist_projects_get_project_collaborators_api_v1_projects_project_id_collaborators_getGet Project Collaborators
todoist_projects_get_section_api_v1_sections_section_id_getGet Section
todoist_projects_get_sections_api_v1_sections_getGet Sections
todoist_projects_join_api_v1_projects_project_id_join_postJoin
todoist_projects_permissions_api_v1_projects_permissions_getPermissions
todoist_projects_search_projects_api_v1_projects_search_getSearch Projects
todoist_projects_search_sections_api_v1_sections_search_getSearch Sections
todoist_projects_unarchive_project_api_v1_projects_project_id_unarchive_postUnarchive Project
todoist_projects_unarchive_section_api_v1_sections_section_id_unarchive_postUnarchive Section
todoist_projects_update_folder_api_v1_folders_folder_id_postUpdate Folder
todoist_projects_update_notification_setting_api_v1_notification_setting_putUpdate Notification Setting
todoist_projects_update_project_api_v1_projects_project_id_postUpdate Project
todoist_projects_update_section_api_v1_sections_section_id_postUpdate Section
todoist_projects_user_info_api_v1_user_getUser Info

todoist_projects_archive_project_api_v1_projects_project_id_archive_post

Archive Project Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringYesString ID of the project

todoist_projects_archive_section_api_v1_sections_section_id_archive_post

Archive Section Parameters:
ParameterTypeRequiredDefaultDescription
section_idstringYesString ID of the section

todoist_projects_create_folder_api_v1_folders_post

Create Folder Parameters:
ParameterTypeRequiredDefaultDescription
child_orderintegerNoUser-specific position of the folder.
default_orderintegerNoDefault position of the folder in the workspace.
namestringYesName of the new folder.
workspace_idstringYesID of the workspace to create the folder in.

todoist_projects_create_project_api_v1_projects_post

Create Project Parameters:
ParameterTypeRequiredDefaultDescription
colorobjectNoColor of the project icon.
descriptionstringNoDescription of the project.
is_favoritebooleanNoWhether the project is a favorite for the user.
namestringYesName of the project.
parent_idstringNoParent project ID. If provided, creates this project as a sub-project
view_stylestringNoView style of the project.
workspace_idstringNoWorkspace ID. If provided, creates a workspace project instead of a personal project.

todoist_projects_create_section_api_v1_sections_post

Create Section Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesName of the new section.
orderintegerNoPosition of the new section in the project
project_idstringYesID of the project to add the section to

todoist_projects_delete_folder_api_v1_folders_folder_id_delete

Delete Folder Parameters:
ParameterTypeRequiredDefaultDescription
folder_idstringYesID of the folder to delete.

todoist_projects_delete_project_api_v1_projects_project_id_delete

Delete Project Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringYesString ID of the project

todoist_projects_delete_section_api_v1_sections_section_id_delete

Delete Section Parameters:
ParameterTypeRequiredDefaultDescription
section_idstringYesString ID of the section

todoist_projects_get_activity_logs_api_v1_activities_get

Get Activity Logs Parameters:
ParameterTypeRequiredDefaultDescription
object_typestringNoThe type of object to filter activities by. Must be one of “project”, “item” (task), “note” (comment), or “section”. When specified with object_id, returns activities for that specific object.
object_idobjectNoThe ID of the specific object to get activities for. Must be used together with object_type. For example, to get activities for a specific task, set object_type=item and object_id=<task_id>.
parent_project_idobjectNoFilter activities to only those belonging to the specified project. Returns activities for the project itself and all its tasks and comments.
parent_item_idobjectNoFilter activities to only those belonging to the specified task. Returns activities for the task itself and all its comments.
include_parent_objectbooleanNoWhen true and object_id is specified, also include activities for the parent object. For example, when filtering by a specific task, also include activities for its parent project.
include_child_objectsbooleanNoWhen true and object_id is specified, also include activities for all child objects. For example, when filtering by a project, also include activities for all its tasks and comments.
initiator_idobjectNoFilter activities to only those initiated by the specified user ID(s). Accepts either a single user ID or a list of user IDs. Useful for shared projects to see who made which changes.
initiator_id_nullbooleanNoFilter by whether the activity has an initiator. When true, returns only activities with no initiator (your own activities). When false, returns only activities initiated by collaborators.
event_typestringNoFilter by a simple event type (e.g., “added”, “deleted”, “completed”). Returns events of this type across ALL object types that support it. For more precise filtering by both object type and event type, use object_event_types instead.
ensure_last_statebooleanNoDeprecated - This parameter has no implementation and will be removed in a future version.
object_event_typesstring[]NoAdvanced filtering for specific object type and event type combinations. Format: ["object_type:event_type"]. Examples: ["item:deleted"] for deleted tasks, ["item:"] for all task events, [":deleted"] for all delete events across all types, ["item:deleted", "note:added"] for multiple filters. Valid event types: “added”, “deleted”, “updated”, “completed”, “uncompleted”, “archived”, “unarchived”, “shared”, “left”, “reordered”, “moved”. This is the recommended way to filter events.
workspace_idobjectNoFilter activities by workspace. Accepts a single workspace ID, a list of workspace IDs, or null to filter for personal projects (projects not belonging to any workspace). Use [null, 123] to include both personal projects and workspace 123. When not set, returns activities from all workspaces and personal projects.
annotate_notesbooleanNoWhen true, includes additional information about comments in the extra_data field, such as the content of the comment.
annotate_parentsbooleanNoWhen true, includes additional information about parent objects in the extra_data field, such as the name of the parent project or task.
cursorstringNoPagination cursor for fetching the next page of results. Use the value returned in the next_cursor field from a previous response.
limitintegerNoThe number of objects to return in a page
date_fromstringNoFilter activities to only those that occurred on or after this date. Must be in ISO 8601 format (e.g. ‘2026-01-01T00:00:00Z’). When specified, overrides the default pagination behavior and allows custom date ranges.
date_tostringNoFilter activities to only those that occurred before this date (exclusive upper bound). Must be in ISO 8601 format (e.g. ‘2026-02-01T00:00:00Z’). When specified, overrides the default pagination behavior and allows custom date ranges.

todoist_projects_get_api_v1_projects_get

Get Projects Parameters:
ParameterTypeRequiredDefaultDescription
folder_idstringNoFilter projects to only those in this folder. If provided, workspace_id is ignored.
workspace_idstringNoFilter projects to only those in this workspace. Ignored if folder_id is also provided.
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_projects_get_archived_api_v1_projects_archived_get

Get Archived Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_projects_get_folder_api_v1_folders_folder_id_get

Get Folder Parameters:
ParameterTypeRequiredDefaultDescription
folder_idstringYesID of the folder to return.

todoist_projects_get_folders_api_v1_folders_get

Get Folders Parameters:
ParameterTypeRequiredDefaultDescription
workspace_idstringYesID of the workspace to list folders for.
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_projects_get_productivity_stats_api_v1_tasks_completed_stats_get

Get Productivity Stats

todoist_projects_get_project_api_v1_projects_project_id_get

Get Project Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringYesString ID of the project

todoist_projects_get_project_collaborators_api_v1_projects_project_id_collaborators_get

Get Project Collaborators Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringYesString ID of the project
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page
public_keystringNoPublic project access key.

todoist_projects_get_section_api_v1_sections_section_id_get

Get Section Parameters:
ParameterTypeRequiredDefaultDescription
section_idstringYesString ID of the section
public_keystringNoPublic project access key.

todoist_projects_get_sections_api_v1_sections_get

Get Sections Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringNoString ID of the project to get sections from. If omitted or null, get sections from all projects.
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page
public_keystringNoPublic project access key.

todoist_projects_join_api_v1_projects_project_id_join_post

Join Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringYesString ID of the workspace project to join.

todoist_projects_permissions_api_v1_projects_permissions_get

Permissions

todoist_projects_search_projects_api_v1_projects_search_get

Search Projects Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesSearch query to match project names. Matching is case-insensitive. Queries are matched literally unless * (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash.
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_projects_search_sections_api_v1_sections_search_get

Search Sections Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesSearch query to match section names. Matching is case-insensitive. Queries are matched literally unless * (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash.
project_idstringNoString ID of the project to search sections from. If omitted or null, search sections from all projects.
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_projects_unarchive_project_api_v1_projects_project_id_unarchive_post

Unarchive Project Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringYesString ID of the project

todoist_projects_unarchive_section_api_v1_sections_section_id_unarchive_post

Unarchive Section Parameters:
ParameterTypeRequiredDefaultDescription
section_idstringYesString ID of the section

todoist_projects_update_folder_api_v1_folders_folder_id_post

Update Folder Parameters:
ParameterTypeRequiredDefaultDescription
folder_idstringYesID of the folder to update.
default_orderintegerNoUpdated default position of the folder. Passing null or omitting this field will leave it unchanged.
namestringNoUpdated folder name. Passing null or omitting this field will leave it unchanged.

todoist_projects_update_notification_setting_api_v1_notification_setting_put

Update Notification Setting Parameters:
ParameterTypeRequiredDefaultDescription
dont_notifybooleanNoWhether notifications should be disabled for the selected type and channel.
notification_typestringYesThe type of notification being sent
servicestringYesWhich communication mechanism is being used to send this notification

todoist_projects_update_project_api_v1_projects_project_id_post

Update Project Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringYesString ID of the project
child_orderintegerNoUpdated position of the project in the hierarchy. Only supported for personal projects. Passing null or omitting this field will leave it unchanged.
colorobjectNoUpdated project color. Passing null or omitting this field will leave it unchanged.
descriptionstringNoUpdated project description. Passing null or omitting this field will leave it unchanged.
folder_idstringNoFolder to move the project into. Only supported for workspace projects. Pass null to clear the value. Omit this field to keep it unchanged.
is_collapsedbooleanNoWhether the project is collapsed. Passing null or omitting this field will leave it unchanged.
is_favoritebooleanNoWhether the project is marked as a favorite. Passing null or omitting this field will leave it unchanged.
namestringNoUpdated project name. Passing null or omitting this field will leave it unchanged.
view_stylestringNoUpdated project view style. Passing null or omitting this field will leave it unchanged.

todoist_projects_update_section_api_v1_sections_section_id_post

Update Section Parameters:
ParameterTypeRequiredDefaultDescription
section_idstringYesString ID of the section
is_collapsedbooleanNoUpdated collapsed state of the section. Passing null or omitting this field will leave it unchanged.
namestringNoUpdated section name. Passing null or omitting this field will leave it unchanged.
section_orderintegerNoUpdated position of the section in the project. Passing null or omitting this field will leave it unchanged.

todoist_projects_user_info_api_v1_user_get

User Info