get_tasks

Retrieve tasks from a ClickUp list with optional filtering capabilities. Use this tool when you need to see existing tasks or analyze your current workload. Before calling, check if you already have the necessary list ID from previous responses in the conversation, as this avoids redundant lookups. Results can be filtered by status, assignees, dates, and more.

Input Schema

Name	Required	Description
`archived`	No	Set to true to include archived tasks in the results
`assignees`	No	Array of user IDs to filter tasks by assignee
`custom_fields`	No	Object with custom field IDs as keys and desired values for filtering
`date_created_gt`	No	Filter tasks created after this timestamp (Unix milliseconds)
`date_created_lt`	No	Filter tasks created before this timestamp (Unix milliseconds)
`date_updated_gt`	No	Filter tasks updated after this timestamp (Unix milliseconds)
`date_updated_lt`	No	Filter tasks updated before this timestamp (Unix milliseconds)
`due_date_gt`	No	Filter tasks due after this timestamp (Unix milliseconds)
`due_date_lt`	No	Filter tasks due before this timestamp (Unix milliseconds)
`include_closed`	No	Set to true to include tasks with 'Closed' status
`listId`	No	ID of the list to get tasks from (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name.
`listName`	No	Name of the list to get tasks from - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses.
`order_by`	No	Field to order tasks by (e.g., 'due_date', 'created', 'updated')
`page`	No	Page number for pagination when dealing with many tasks (starts at 0)
`reverse`	No	Set to true to reverse the sort order (descending instead of ascending)
`statuses`	No	Array of status names to filter tasks by (e.g., ['To Do', 'In Progress'])
`subtasks`	No	Set to true to include subtasks in the results

Input Schema (JSON Schema)

{
  "oneOf": [
    {
      "required": [
        "listId"
      ]
    },
    {
      "required": [
        "listName"
      ]
    }
  ],
  "properties": {
    "archived": {
      "description": "Set to true to include archived tasks in the results",
      "type": "boolean"
    },
    "assignees": {
      "description": "Array of user IDs to filter tasks by assignee",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "custom_fields": {
      "description": "Object with custom field IDs as keys and desired values for filtering",
      "type": "object"
    },
    "date_created_gt": {
      "description": "Filter tasks created after this timestamp (Unix milliseconds)",
      "type": "number"
    },
    "date_created_lt": {
      "description": "Filter tasks created before this timestamp (Unix milliseconds)",
      "type": "number"
    },
    "date_updated_gt": {
      "description": "Filter tasks updated after this timestamp (Unix milliseconds)",
      "type": "number"
    },
    "date_updated_lt": {
      "description": "Filter tasks updated before this timestamp (Unix milliseconds)",
      "type": "number"
    },
    "due_date_gt": {
      "description": "Filter tasks due after this timestamp (Unix milliseconds)",
      "type": "number"
    },
    "due_date_lt": {
      "description": "Filter tasks due before this timestamp (Unix milliseconds)",
      "type": "number"
    },
    "include_closed": {
      "description": "Set to true to include tasks with 'Closed' status",
      "type": "boolean"
    },
    "listId": {
      "description": "ID of the list to get tasks from (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name.",
      "type": "string"
    },
    "listName": {
      "description": "Name of the list to get tasks from - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses.",
      "type": "string"
    },
    "order_by": {
      "description": "Field to order tasks by (e.g., 'due_date', 'created', 'updated')",
      "type": "string"
    },
    "page": {
      "description": "Page number for pagination when dealing with many tasks (starts at 0)",
      "type": "number"
    },
    "reverse": {
      "description": "Set to true to reverse the sort order (descending instead of ascending)",
      "type": "boolean"
    },
    "statuses": {
      "description": "Array of status names to filter tasks by (e.g., ['To Do', 'In Progress'])",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "subtasks": {
      "description": "Set to true to include subtasks in the results",
      "type": "boolean"
    }
  },
  "type": "object"
}

get_tasks

Input Schema

Input Schema (JSON Schema)

Other Tools