get_list

get_list

Retrieve details about a specific ClickUp list including its name, content, status options, and other metadata. Before calling, check if you already have the necessary list ID from previous responses in the conversation history, as this avoids redundant lookups. Useful to understand list structure before creating or updating tasks.

Input Schema

Name	Required	Description	Default
`listId`	No	ID of the list to retrieve (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 retrieve - 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.

Input Schema (JSON Schema)

{
  "oneOf": [
    {
      "required": [
        "listId"
      ]
    },
    {
      "required": [
        "listName"
      ]
    }
  ],
  "properties": {
    "listId": {
      "description": "ID of the list to retrieve (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 retrieve - 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"
    }
  },
  "type": "object"
}

Input Schema

Input Schema (JSON Schema)

Other Tools