ClickUp MCP Server

Get the complete workspace hierarchy including spaces, folders, and lists.

Create a single task in a ClickUp list. Use this tool for individual task creation only. For multiple tasks, use create_bulk_tasks instead. Before calling this tool, check if you already have the necessary list ID from previous responses in the conversation history, as this avoids redundant lookups. When creating a task, you must provide either a listId or listName.

Retrieve detailed information about a specific task. Valid parameter combinations:

1. Use taskId alone (preferred)

2. Use taskName + optional listName (to disambiguate if multiple tasks have the same name)

Retrieve tasks from a list with optional filtering. You MUST provide either:

1. listId (preferred)

2. listName

Use filters to narrow down results by status, dates, etc.

Modify an existing task's properties. Valid parameter combinations:

1. Use taskId alone (preferred if you have it)

2. Use taskName + optional listName (to disambiguate if multiple tasks have the same name)

At least one update field (name, description, status, priority) must be provided. Only specified fields will be updated.

Move a task to a different list. Valid parameter combinations:

1. Use taskId + (listId or listName) - preferred

2. Use taskName + sourceListName + (listId or listName)

WARNING: Task statuses may reset if destination list has different status options.

Create a copy of a task in the same or different list. Valid parameter combinations:

1. Use taskId + optional (listId or listName) - preferred

2. Use taskName + sourceListName + optional (listId or listName)

The duplicate preserves the original task's properties.

⚠️ PERMANENTLY DELETE a task. This action cannot be undone. Valid parameter combinations:

1. Use taskId alone (preferred and safest)

2. Use taskName + optional listName (use with caution)

Create multiple tasks in a list efficiently. You MUST provide:

1. An array of tasks with required properties

2. Either listId or listName to specify the target list

Optional: Configure batch size and concurrency for performance.

Update multiple tasks efficiently. For each task, you MUST provide either:

1. taskId alone (preferred)

2. taskName + listName

Only specified fields will be updated for each task.

Move multiple tasks to a different list efficiently. For each task, you MUST provide either:

1. taskId alone (preferred)

2. taskName + listName

WARNING: Task statuses may reset if target list has different status options.

⚠️ PERMANENTLY DELETE multiple tasks. This action cannot be undone. For each task, you MUST provide either:

1. taskId alone (preferred and safest)

2. taskName + listName (use with caution)

Create a new list directly in a ClickUp space (not in a folder). You MUST provide either spaceId or spaceName. For creating lists inside folders, use create_list_in_folder instead.

Create a new list within a ClickUp folder. You MUST provide either: 1) folderId alone, or 2) folderName WITH either spaceName or spaceId. Folder names may not be unique across spaces, which is why space information is required when using folderName.

Retrieve details about a specific ClickUp list. You MUST provide either listId or listName. Using listId is more reliable as list names might not be unique.

Update an existing ClickUp list's properties. You MUST provide either listId or listName, and at least one field to update (name, content, or status).

Permanently delete a ClickUp list and all its tasks. You MUST provide either listId or listName. WARNING: This action cannot be undone.

Create a new folder in a ClickUp space for organizing related lists. You MUST provide:

1. A folder name

2. Either spaceId (preferred) or spaceName

After creating a folder, you can add lists to it using create_list_in_folder.

Retrieve details about a specific folder including name, status, and metadata. Valid parameter combinations:

1. Use folderId alone (preferred)

2. Use folderName + (spaceId or spaceName)

Helps you understand folder structure before creating or updating lists.

Modify an existing folder's properties. Valid parameter combinations:

1. Use folderId alone (preferred)

2. Use folderName + (spaceId or spaceName)

At least one update field (name or override_statuses) must be provided.

⚠️ PERMANENTLY DELETE a folder and all its contents. This action cannot be undone. Valid parameter combinations:

1. Use folderId alone (preferred and safest)

2. Use folderName + (spaceId or spaceName)

WARNING: This will also delete all lists and tasks within the folder.