create_list

create_list

Create a new top-level list in a ClickUp space using a space ID or name. Assign tasks, set priorities, due dates, and statuses to organize tasks efficiently.

Instructions

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

Name	Required	Description
`assignee`	No	User ID to assign the list to
`content`	No	Description or content of the list
`dueDate`	No	Due date for the list (Unix timestamp in milliseconds). Convert dates to this format before submitting.
`name`	Yes	Name of the list
`priority`	No	Priority of the list (1-4), where 1 is urgent/highest priority and 4 is lowest priority. Only set when explicitly requested.
`spaceId`	No	ID of the space to create the list in (optional if using spaceName instead). If you have this ID from a previous response, use it directly rather than looking up by name.
`spaceName`	No	Name of the space to create the list in - will automatically find the space by name (optional if using spaceId instead). Only use this if you don't already have the space ID from previous responses.
`status`	No	Status of the list

Input Schema (JSON Schema)

{
  "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"
    },
    "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 (optional if using spaceName instead). If you have this ID from a previous response, use it directly rather than looking up by name.",
      "type": "string"
    },
    "spaceName": {
      "description": "Name of the space to create the list in - will automatically find the space by name (optional if using spaceId instead). Only use this if you don't already have the space ID from previous responses.",
      "type": "string"
    },
    "status": {
      "description": "Status of the list",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

ClickUp MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from ClickUp MCP Server

Related Tools