create_list_in_folder

Create a new list within a ClickUp folder. Use this tool when you need to add a list to an existing folder structure. Before calling, check if you already have the necessary folder ID and space ID from previous responses in the conversation, as this avoids redundant lookups. For top-level lists not in folders, use create_list instead.

Input Schema

Name	Required	Description
`content`	No	Description or content of the list
`folderId`	No	ID of the folder to create the list in (optional if using folderName instead). If you have this ID from a previous response, use it directly rather than looking up by name.
`folderName`	No	Name of the folder to create the list in - will automatically find the folder by name (optional if using folderId instead). Only use this if you don't already have the folder ID from previous responses.
`name`	Yes	Name of the list
`spaceId`	No	ID of the space containing the folder (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 containing the folder - 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 (uses folder default if not specified)

Input Schema (JSON Schema)

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

ClickUp MCP Server

create_list_in_folder

Input Schema

Input Schema (JSON Schema)

Other Tools