← Tools Reference

Todoist

Todoist integration (Productivity). Imported from open-connector.

OAuth12 toolshttps://api.todoist.com/api/v1
GET
todoist_get_current_user
Get the current Todoist user profile.

/user

GET
todoist_list_projects
List Todoist projects visible to the connected account.

/projects

4 parameters
ParamTypeRequiredDescription
folderIdintegeroptionalOptional Todoist folder ID to filter projects by.
workspaceIdintegeroptionalOptional Todoist workspace ID to filter projects by.
cursorstringoptionalOpaque pagination cursor returned by a previous Todoist response.
limitintegeroptionalMaximum number of Todoist results to return in one page.
GET
todoist_get_project
Get one Todoist project by ID.

/projects/{projectId}

1 parameter
ParamTypeRequiredDescription
projectIdstringrequiredTodoist project ID.
GET
todoist_list_sections
List Todoist sections, optionally scoped to a project.

/sections

3 parameters
ParamTypeRequiredDescription
projectIdstringoptionalOptional Todoist project ID.
cursorstringoptionalOpaque pagination cursor returned by a previous Todoist response.
limitintegeroptionalMaximum number of Todoist results to return in one page.
GET
todoist_get_section
Get one Todoist section by ID.

/sections/{sectionId}

1 parameter
ParamTypeRequiredDescription
sectionIdstringrequiredTodoist section ID.
GET
todoist_list_tasks
List Todoist tasks using the API v1 filters.

/tasks

8 parameters
ParamTypeRequiredDescription
projectIdstringoptionalOptional Todoist project ID filter.
sectionIdstringoptionalOptional Todoist section ID filter.
parentIdstringoptionalOptional Todoist parent task ID filter.
labelstringoptionalOptional Todoist label name filter.
idsarrayoptionalExplicit Todoist task IDs to fetch.
goalIdstringoptionalOptional Todoist goal ID filter.
cursorstringoptionalOpaque pagination cursor returned by a previous Todoist response.
limitintegeroptionalMaximum number of Todoist results to return in one page.
GET
todoist_get_task
Get one Todoist task by ID.

/tasks/{taskId}

1 parameter
ParamTypeRequiredDescription
taskIdstringrequiredTodoist task ID.
POST
todoist_close_task
Close a Todoist task.

/tasks/{taskId}/close

1 parameter
ParamTypeRequiredDescription
taskIdstringrequiredTodoist task ID.
GET
todoist_list_comments
List Todoist comments by task or project.

/comments

4 parameters
ParamTypeRequiredDescription
taskIdstringoptionalOptional task ID filter.
projectIdstringoptionalOptional project ID filter.
cursorstringoptionalOpaque pagination cursor returned by a previous Todoist response.
limitintegeroptionalMaximum number of Todoist results to return in one page.
GET
todoist_get_comment
Get one Todoist comment by ID.

/comments/{commentId}

1 parameter
ParamTypeRequiredDescription
commentIdstringrequiredTodoist comment ID.
POST
todoist_update_comment
Update a Todoist comment.

/comments/{commentId}

2 parameters
ParamTypeRequiredDescription
commentIdstringrequiredTodoist comment ID.
contentstringoptionalUpdated Todoist comment content.
GET
todoist_list_labels
List Todoist labels visible to the connected account.

/labels

2 parameters
ParamTypeRequiredDescription
cursorstringoptionalOpaque pagination cursor returned by a previous Todoist response.
limitintegeroptionalMaximum number of Todoist results to return in one page.