delete_list

Permanently delete a list and its tasks from your ClickUp workspace. Requires the list ID or name to confirm removal. Use with caution, as this action is irreversible.

Instructions

Permanently remove a list from your ClickUp workspace. Use with caution as deletion cannot be undone and will remove all tasks within the list. Before calling, check if you already have the necessary list ID from previous responses in the conversation history, as this avoids redundant lookups.

Input Schema

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

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

ClickUp MCP Server

delete_list

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from ClickUp MCP Server

Related Tools