ClickUp MCP Server

by v4lheru
Verified

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CLICKUP_API_KEYYesYour ClickUp API key
CLICKUP_TEAM_IDYesYour ClickUp team ID

Schema

Prompts

Interactive templates invoked by user choice

NameDescription
summarize_tasksGenerate a comprehensive summary of tasks in a ClickUp list or workspace. The summary includes a high-level overview, groups tasks by status, highlights priority items, and identifies potential task relationships or dependencies. Useful for project status reports and team updates.
analyze_prioritiesEvaluate task priority distribution across your workspace and identify optimization opportunities. The analysis examines current priority assignments, identifies misaligned priorities, suggests adjustments, and recommends task sequencing based on priorities. Helpful for workload management and project planning.
generate_descriptionCreate a detailed, well-structured task description with clearly defined objectives, success criteria, required resources, dependencies, and risk assessments. This prompt helps ensure tasks are comprehensively documented with all necessary information for successful execution.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
add_task_dependency

Create a dependency relationship between two tasks. Use this to establish that one task must be completed before another can start. You must specify either 'dependsOn' (the task that must be completed first) or 'dependencyOf' (the task that's waiting for this task), but not both.

delete_task_dependency

Remove a dependency relationship between two tasks. This allows tasks to be completed independently of each other.

add_task_link

Create a link between two tasks. Unlike dependencies, links are just references between related tasks without enforcing completion order.

delete_task_link

Remove a link between two tasks. This removes the reference between the tasks.

add_tag_to_task

Add a tag to a task for better organization and filtering. Tags help categorize tasks across different lists and projects.

remove_tag_from_task

Remove a tag from a task. This does not delete the tag from the Space, just removes it from the specific task.

get_task_comments

Retrieve comments for a specific task. Comments provide discussion history and context for the task.

create_task_comment

Add a new comment to a task. Comments can be assigned to team members and include rich text formatting.

get_list_comments

Retrieve comments for a specific list. List comments apply to the entire list rather than individual tasks.

create_list_comment

Add a new comment to a list. List comments can be used for general discussion about the list's purpose or status.

get_chat_view_comments

Retrieve comments from a Chat view. Chat views provide a dedicated space for team discussions.

create_chat_view_comment

Add a new comment to a Chat view. Chat view comments facilitate team discussions outside of specific tasks or lists.

update_comment

Modify an existing comment. This can be used to edit the content, change assignees, or mark comments as resolved.

delete_comment

Remove a comment. This permanently deletes the comment and cannot be undone.

get_threaded_comments

Retrieve threaded comments for a parent comment. Threaded comments allow for organized discussions within a comment thread.

create_threaded_comment

Add a reply to an existing comment. Threaded comments help keep discussions organized by grouping related comments together.

create_checklist

Add a new checklist to a task. Checklists help organize subtasks or steps needed to complete a task.

edit_checklist

Rename a task checklist or reorder it among other checklists on a task.

delete_checklist

Delete a checklist from a task. This removes the entire checklist and all its items.

create_checklist_item

Add a line item to a task checklist. Checklist items represent individual steps or subtasks.

edit_checklist_item

Update an individual line item in a task checklist. Use this to rename, reassign, mark as resolved, or nest items.

delete_checklist_item

Delete a line item from a task checklist. This permanently removes the item.

get_workspace_hierarchy

Retrieve the complete ClickUp workspace hierarchy, including all spaces, folders, and lists with their IDs, names, and hierarchical paths. Call this tool only when you need to discover the workspace structure and don't already have this information from recent context. Avoid using for repeated lookups of the same information.

create_task

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.

create_bulk_tasks

Create multiple tasks in a ClickUp list simultaneously. Use this tool when you need to add several related tasks in one operation. Before calling, check if you already have the necessary list ID from previous responses in the conversation, as this avoids redundant lookups. More efficient than creating tasks one by one for batch operations.

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.

create_folder

Create a new folder in a ClickUp space for organizing related lists. Use this tool when you need to group multiple lists together. Before calling, check if you already have the necessary space ID from previous responses in the conversation, as this avoids redundant lookups. After creating a folder, you can add lists to it using create_list_in_folder.

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.

move_task

Move an existing task from its current list to a different list. Use this tool when you need to relocate a task within your workspace hierarchy. Before calling, check if you already have the necessary task ID and list ID from previous responses in the conversation, as this avoids redundant lookups. Task statuses may be reset if the destination list uses different status options.

duplicate_task

Create a copy of an existing task in the same or different list. Use this tool when you need to replicate a task's content and properties. Before calling, check if you already have the necessary task ID and list ID from previous responses in the conversation, as this avoids redundant lookups. The duplicate will preserve name, description, priority, and other attributes from the original task.

update_task

Modify the properties of an existing task. Use this tool when you need to change a task's name, description, status, priority, or due date. Before calling, check if you already have the necessary task ID from previous responses in the conversation, as this avoids redundant lookups. Only the fields you specify will be updated; other fields will remain unchanged.

get_tasks

Retrieve tasks from a ClickUp list with optional filtering capabilities. Use this tool when you need to see existing tasks or analyze your current workload. Before calling, check if you already have the necessary list ID from previous responses in the conversation, as this avoids redundant lookups. Results can be filtered by status, assignees, dates, and more.

get_task

Retrieve comprehensive details about a specific ClickUp task. Use this tool when you need in-depth information about a particular task, including its description, custom fields, attachments, and other metadata. Before calling, check if you already have the necessary task ID from previous responses in the conversation, as this avoids redundant lookups.

delete_task

Permanently remove a task from your ClickUp workspace. Use this tool with caution as deletion cannot be undone. Before calling, check if you already have the necessary task ID from previous responses in the conversation, as this avoids redundant lookups. For safety, the task ID is required.

get_folder

Retrieve details about a specific ClickUp folder including its name, status, and other metadata. Before calling, check if you already have the necessary folder ID from previous responses in the conversation history, as this avoids redundant lookups. Helps you understand folder structure before creating or updating lists.

update_folder

Modify an existing ClickUp folder's properties, such as name or status settings. Before calling, check if you already have the necessary folder ID from previous responses in the conversation history, as this avoids redundant lookups. Use when reorganizing or renaming workspace elements.

delete_folder

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

get_list

Retrieve details about a specific ClickUp list including its name, content, status options, and other metadata. Before calling, check if you already have the necessary list ID from previous responses in the conversation history, as this avoids redundant lookups. Useful to understand list structure before creating or updating tasks.

update_list

Modify an existing ClickUp list's properties, such as name, content, or status options. Before calling, check if you already have the necessary list ID from previous responses in the conversation history, as this avoids redundant lookups. Use when reorganizing or renaming workspace elements.

delete_list

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.