find-completed-tasks
Read-onlyIdempotent
Retrieve completed tasks from Todoist filtered by date range, project, section, labels, or responsible user. Supports pagination and optional cursor for large result sets.
Instructions
Get completed tasks. since/until are optional and default to a 7-day window when omitted. Includes all collaborators by default. Person-specific queries (summaries, plans, reports) require responsibleUser.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| getBy | No | The method to use to get the tasks: "completion" to get tasks by completion date (ie, when the task was actually completed), "due" to get tasks by due date (ie, when the task was due to be completed by). | completion |
| limit | No | The maximum number of tasks to return. | |
| since | No | Optional start date for completed tasks. Format: YYYY-MM-DD. Defaults to 6 days before until (or today if until is omitted), resulting in a 7-day window. | |
| until | No | Optional end date for completed tasks. Format: YYYY-MM-DD. Defaults to 6 days after since (or today if since is omitted), resulting in a 7-day window. | |
| cursor | No | The cursor to get the next page of tasks (cursor is obtained from the previous call to this tool, with the same parameters). | |
| labels | No | The labels to filter the tasks by | |
| parentId | No | The ID of the parent task to get the tasks for. | |
| projectId | No | The ID of the project to get the tasks for. Project ID should be an ID string, or the text "inbox", for inbox tasks. | |
| sectionId | No | The ID of the section to get the tasks for. | |
| workspaceId | No | The ID of the workspace to get the tasks for. | |
| labelsOperator | No | The operator to use when filtering by labels. This will dictate whether a task has all labels, or some of them. Default is "or". | |
| responsibleUser | No | Filter completed tasks assigned to this user. User ID, name, or email. For personal queries (summaries, plans, reports), set to current user from user-info to exclude collaborators. Defaults to all collaborators. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tasks | Yes | The found completed tasks. | |
| hasMore | Yes | Whether there are more results available. | |
| nextCursor | No | Cursor for the next page of results. | |
| totalCount | Yes | The total number of tasks in this page. | |
| appliedFilters | Yes | The filters that were applied to the search. |