ClickUp

Create a new task in a ClickUp list with optional planning metadata. Use this tool when you want to add a task to a specific list and optionally set its initial status, priority, scheduling information, and hierarchy.

Create a new comment on a ClickUp task with optional assignment. Use this tool to add text comments to tasks. You can optionally assign the comment to a specific user for follow-up.

Create a new threaded reply to an existing ClickUp comment. Use this tool to add threaded replies to comments, creating conversation threads. You can optionally assign the reply to a specific user for follow-up.

Search for folders using fuzzy matching on folder names. This tool should ONLY be used when you cannot find the desired folder through normal context or direct searches. It performs fuzzy matching against folder names and returns simplified folder information. Use other ClickUp tools to get full folder details or work with the folders. This tool is also useful to avoid navigating through the ClickUp hierarchy tree when you know approximately what folder/project you're looking for but don't know its exact location in the hierarchy. In ClickUp, folders are also known as projects and serve as organizational containers for lists. Returns folders that match the name_to_search with match scores indicating relevance (1.0 = perfect match, lower scores = less relevant matches).

Search for lists using fuzzy matching on list names. This tool should ONLY be used when you cannot find the desired list through normal context or direct searches. It performs fuzzy matching against list names and returns simplified list information. Use other ClickUp tools to get full list details or work with the lists. This tool is also useful to avoid navigating through the ClickUp hierarchy tree when you know approximately what list you're looking for but don't know its exact location in the hierarchy. Returns lists that match the name_to_search with match scores indicating relevance (1.0 = perfect match, lower scores = less relevant matches).

Search for workspace members using fuzzy matching on member names. This tool should ONLY be used when you cannot find the desired team member through normal context It performs fuzzy matching against member names and returns simplified member information including ID, name, and email. Returns team members that match the name_to_search with match scores indicating relevance (1.0 = perfect match, lower scores = less relevant matches).

Search for tasks using fuzzy matching on task names. This tool should ONLY be used when you cannot find the desired task through normal context or direct searches. It performs fuzzy matching against task names and returns simplified task information. Use the returned task IDs with get_task_by_id to retrieve full task details. This tool is also useful to avoid navigating through the ClickUp hierarchy tree when you know approximately what task you're looking for but don't know its exact location in the hierarchy. Returns the most recently updated tasks that match the name_to_search with match scores indicating relevance (1.0 = perfect match, lower scores = less relevant matches).

Retrieve folders (also called directories, project categories, or project areas) from a ClickUp space. Only use this tool when you already have the space ID and want to see the folders within that specific space. Important: When users mention a space(or area), always use this tool to get the folders within that space. This tool fetches folders from the specified space with support for offset-based retrieval and archived folder filtering. Results are sorted alphabetically by name.

Retrieve task lists from a ClickUp folder (when users refer to a folder as a "directory", they mean the same thing). Only use this tool when you already have the folder ID and want to see the lists within that specific folder. Important: When users mention a specific folder(or directory), always use this tool to get the lists within that folder. This tool fetches lists from the specified folder with support for offset-based retrieval and archived list filtering. Results are sorted alphabetically by name.

Retrieve all task lists from a ClickUp space by collecting lists from all folders within the space. Only use this tool when you have a space ID and want to see all lists across all folders within that space. This tool provides a comprehensive view of all lists in a space with support for offset-based retrieval and archived list filtering. Results are sorted alphabetically by name.

Retrieve all team members from a specific ClickUp workspace. Only use this tool when you already have the workspace ID and need to see the members within that specific workspace. This tool fetches detailed information about all members of a ClickUp workspace, including their basic profile information and role within the workspace. Results are sorted and support offset-based retrieval.

Retrieve spaces from a ClickUp workspace. Use this tool when users ask for: - Spaces within a workspace (not folders or lists) - Available spaces to choose from before getting folders - Space discovery when you need to identify space IDs or names - High-level workspace organization structure Note: This is for spaces (top-level containers), not folders (which contain lists) nor lists. This tool fetches spaces from the specified workspace with support for offset-based retrieval and archived space filtering. Results are sorted alphabetically by name.

Retrieve the possible task statuses for a specific ClickUp list. Only use this tool when you already have the list ID and need to discover the valid statuses for that specific list. Use this tool to discover valid status labels and their ordering/type for a list before creating or updating tasks, since statuses can be customized per list.

Return static guidance intended solely to help agents make informed decisions. Important: The guidance content is for internal agent use only and should not be displayed to end users.

Get detailed information about a specific task by its ID. Also supports custom task IDs when workspace_id_for_custom_id is provided. Use when need more information about a task than if it id or custom id is already known.

Get threaded replies for a specific ClickUp comment with pagination support. This tool retrieves replies to a parent comment using ClickUp's threaded comment system with offset-based pagination. The parent comment itself is not included in the results, only the threaded replies.

Get comments for a specific ClickUp task with pagination support. This tool retrieves comments from a task using ClickUp's specific pagination method. For the first call, omit oldest_comment_id. For subsequent calls, use the oldest_comment_id from the previous response to get the next set of comments.

Get filtered tasks assigned to specific team members with advanced filtering options. This tool filters tasks by assignee(s) across the entire workspace. Provides comprehensive filtering capabilities including status and date range filtering. Important: Use this tool when not interested in a specific task but a set of tasks from a specific assignee or filtering criteria that does not include the task title(name).

Get filtered tasks from ClickUp with advanced filtering options. This unified tool filters tasks at different organizational levels: Important: Use this tool when not interested in a specific task but a set of tasks from a specific scope or filtering criteria that does not include the task title(name).

Return a brief overview for a workspace using the latest updated tasks to inform the user. Includes task summary, team insights, and container(space, folder, list) insights.

Update one or more fields of an existing ClickUp task. Use this tool to change a task's title, description, status, priority, dates, hierarchy (by setting a new parent), or sprint points. You can pass only the fields you want to modify—everything else remains unchanged.

Update task assignees by adding and/or removing specific users. Use this tool to manage task assignments by specifying which users to add or remove. You can add assignees, remove assignees, or do both in a single operation. At least one of the parameters (assignee_ids_to_add or assignee_ids_to_remove) must be provided.

Update an existing comment on a ClickUp task. This tool is for updating top-level comments only, not threaded comment replies. Use this tool to modify comment text, change assignment, or set resolution status. At least one parameter (comment_text, assignee_id, or resolution) must be provided.

Return current user profile and accessible workspaces (teams). This should be the FIRST tool called when starting any ClickUp interaction. Each workspace represents a separate team or organization with its own members, projects, and settings.