ClickUp MCP Server
Server Configuration
Describes the environment variables required to run the server.
Name | Required | Description | Default |
---|---|---|---|
CLICKUP_API_KEY | Yes | Your ClickUp API key | |
CLICKUP_TEAM_ID | Yes | Your ClickUp team ID |
Schema
Prompts
Interactive templates invoked by user choice
Name | Description |
---|---|
summarize_tasks | Generate 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_priorities | Evaluate 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_description | Create 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
Name | Description |
---|---|
No resources |
Tools
Functions exposed to the LLM to take actions
Name | Description |
---|---|
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. |