find-projects
Read-onlyIdempotent
Search and list Todoist projects by name, with filters for active, archived, or all projects. Supports partial matches and pagination.
Instructions
List all projects or search for projects by name. By default only active projects are returned; use archivedStatus ('archived' or 'all') to include archived projects. When searching or when archivedStatus is 'all', all matching projects are returned (pagination is ignored). Otherwise projects are returned with pagination.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | The maximum number of projects to return. | |
| cursor | No | The cursor to get the next page of projects (cursor is obtained from the previous call to this tool, with the same parameters). | |
| searchText | No | Search for a project by name (partial and case insensitive match). Supports wildcards (e.g. "work*" for prefix match). Use "\*" for a literal asterisk. If omitted, all projects are returned. | |
| archivedStatus | No | Which projects to return by archive status: 'active' (default, non-archived only), 'archived' (archived only), or 'all' (both active and archived). Each project includes an isArchived field. Archived projects can be deleted via the delete-object tool (type: 'project'). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hasMore | Yes | Whether there are more results available. | |
| projects | Yes | The found projects. | |
| nextCursor | No | Cursor for the next page of results. | |
| totalCount | Yes | The total number of projects in this page. | |
| appliedFilters | Yes | The filters that were applied to the search. |