ClickUp MCP Server

by v4lheru
Verified

create_list

Create a new list directly in a ClickUp space. Use this tool when you need a top-level list not nested inside a folder. Before calling, check if you already have the necessary space ID from previous responses in the conversation, as this avoids redundant lookups. For creating lists inside folders, use create_list_in_folder instead.

Input Schema

NameRequiredDescriptionDefault
assigneeNoUser ID to assign the list to
contentNoDescription or content of the list
dueDateNoDue date for the list (Unix timestamp in milliseconds). Convert dates to this format before submitting.
folderIdNoID of the folder to create the list in (required if not using spaceId). If you have this ID from a previous response, use it directly rather than looking up by name.
nameNoName of the list
priorityNoPriority of the list (1-4), where 1 is urgent/highest priority and 4 is lowest priority. Only set when explicitly requested.
spaceIdNoID of the space to create the list in (required if not using folderId). If you have this ID from a previous response, use it directly rather than looking up by name.
statusNoStatus of the list

Input Schema (JSON Schema)

{ "allOf": [ { "oneOf": [ { "required": [ "spaceId" ] }, { "required": [ "folderId" ] } ] }, { "required": [ "name" ] } ], "properties": { "assignee": { "description": "User ID to assign the list to", "type": "number" }, "content": { "description": "Description or content of the list", "type": "string" }, "dueDate": { "description": "Due date for the list (Unix timestamp in milliseconds). Convert dates to this format before submitting.", "type": "string" }, "folderId": { "description": "ID of the folder to create the list in (required if not using spaceId). If you have this ID from a previous response, use it directly rather than looking up by name.", "type": "string" }, "name": { "description": "Name of the list", "type": "string" }, "priority": { "description": "Priority of the list (1-4), where 1 is urgent/highest priority and 4 is lowest priority. Only set when explicitly requested.", "type": "number" }, "spaceId": { "description": "ID of the space to create the list in (required if not using folderId). If you have this ID from a previous response, use it directly rather than looking up by name.", "type": "string" }, "status": { "description": "Status of the list", "type": "string" } }, "type": "object" }