clickup_task_search
Search tasks across your ClickUp workspace using filters like assignee, status, tags, dates, custom fields, and more. Returns a paginated list of matching tasks.
Instructions
Search tasks across an entire ClickUp workspace with ClickUp's filtered team tasks endpoint. Supports hierarchy, assignee, status, tag, date range, custom field, custom item type, parent/subtask, and ordering filters. Returns a paginated array of task objects. For tasks in a single list, prefer clickup_task_list (fewer parameters, same shape).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assignees | No | User IDs (as strings) to restrict to tasks assigned to them. Obtain from clickup_member_list. Omit to return tasks regardless of assignee. | |
| custom_fields | No | ClickUp custom field filters. Each object is sent inside the custom_fields JSON query parameter, e.g. [{"field_id":"...","operator":"=","value":"..."}]. Use operators supported by ClickUp, including IS NULL / IS NOT NULL for unset/set checks. | |
| custom_items | No | Filter by ClickUp custom task type IDs. Include 0 for regular tasks, 1 for milestones, or workspace-defined custom item type IDs. | |
| date_created_gt | No | Filter tasks created after this Unix timestamp in milliseconds. | |
| date_created_lt | No | Filter tasks created before this Unix timestamp in milliseconds. | |
| date_done_gt | No | Filter tasks completed after this Unix timestamp in milliseconds. | |
| date_done_lt | No | Filter tasks completed before this Unix timestamp in milliseconds. | |
| date_updated_gt | No | Filter tasks updated after this Unix timestamp in milliseconds. | |
| date_updated_lt | No | Filter tasks updated before this Unix timestamp in milliseconds. | |
| due_date_gt | No | Filter tasks with due_date greater than this Unix timestamp in milliseconds. | |
| due_date_lt | No | Filter tasks with due_date less than this Unix timestamp in milliseconds. | |
| include_closed | No | true = include tasks in closed statuses; false or omitted = exclude closed tasks. | |
| include_markdown_description | No | true = ask ClickUp to return task descriptions in Markdown format. | |
| list_ids | No | Restrict results to these list IDs. Obtain from clickup_list_list (field: id). Omit to search all lists. | |
| order_by | No | Sort field supported by ClickUp, such as id, created, updated, or due_date. | |
| parent | No | Parent task ID. When set, returns subtasks under this parent task. | |
| project_ids | No | Restrict results to these folder/project IDs. ClickUp's API parameter is project_ids[]. Obtain IDs from clickup_folder_list. | |
| reverse | No | true = reverse the selected sort order. | |
| space_ids | No | Restrict results to these space IDs. Obtain from clickup_space_list (field: id). Omit to search all spaces. | |
| statuses | No | Status names to include (e.g. ['open','in review']). Case-sensitive. Omit for any open status. | |
| subtasks | No | true = include subtasks in search results; false or omitted = exclude subtasks unless parent is provided. | |
| tags | No | Tag names to filter by. Tags must match ClickUp tag names in the relevant spaces. | |
| team_id | No | Workspace (team) ID to search within. Obtain from clickup_workspace_list (field: id). Omit to use the default workspace from config. |