get_list

Retrieve ClickUp list details, including name, content, and status options, using either list ID or name. Use to understand list structure before creating or updating tasks, minimizing redundant lookups.

Instructions

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"
}

ClickUp MCP Server

get_list

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from ClickUp MCP Server

Related Tools