Clickup

The ClickUp toolkit provides tools to interact with ClickUp workspaces, projects (spaces/folders/lists), tasks, comments, and members. It enables building agents and apps that can:

• Discover workspace structure and users.
• Create, view, and modify tasks.
• Manage task assignments and task planning metadata.
• Work with comments and threaded replies.
• Search for containers and people by approximate name when location is unknown.
• Retrieve guidance for agent decision-making.

Available Tools

Clickup.GetTaskCommentReplies

Get threaded replies for a specific ClickUp comment with pagination support.

Parameters

• comment_id (string, required) The ClickUp comment ID to get replies for
• offset (integer, optional) Starting position for offset-based retrieval (default: 0)
• limit (integer, optional) Maximum number of replies to return (max: 50, default: 20)

Clickup.CreateTaskCommentReply

Create a new threaded reply to an existing ClickUp comment.

Parameters

• comment_id (string, required) The ClickUp comment ID to reply to
• reply_text (string, required) The text content of the reply
• assignee_id (integer, optional) User ID to assign the reply to

Clickup.CreateTask

Create a new task in a ClickUp list with optional planning metadata.

Parameters

• list_id (string, required) The ClickUp list ID where the task will be created
• task_title (string, required) The name/title of the task
• description (string, optional) The description/content of the task
• priority (Enum TaskPriority, optional) Task priority
• status (string, optional) Task status label (string)
• parent_task_id (string, optional) The parent task ID if this is a subtask
• start_date (string, optional) Date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS]; ISO-8601 also supported
• due_date (string, optional) Date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS]; ISO-8601 also supported
• sprint_points (integer, optional) The sprint points for the task

Clickup.GetTaskById

Get detailed information about a specific task by its ID. Also supports custom task IDs

Parameters

• task_id (string, required) The task ID or custom task ID to retrieve
• include_subtasks (boolean, optional) Include subtask information (default: false )
• workspace_id_for_custom_id (string, optional) The ClickUp workspace ID (provide this to use custom task IDs)

Clickup.UpdateTask

Update one or more fields of an existing ClickUp task.

Parameters

• task_id (string, required) The ClickUp task ID to update
• task_title (string, optional) The new name/title of the task
• description (string, optional) The new description/content of the task
• priority (Enum TaskPriority, optional) Task priority
• status (string, optional) Task status label (string)
• parent_task_id (string, optional) The new parent task ID
• start_date (string, optional) Date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS]; ISO-8601 also supported
• due_date (string, optional) Date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS]; ISO-8601 also supported
• sprint_points (integer, optional) The new sprint points for the task

Clickup.GetTasksByScope

Get filtered tasks from ClickUp with advanced filtering options.

Parameters

• workspace_id (string, required) The ClickUp workspace ID for GUI URL generation (should be a number)
• scope (Enum FilterScope, required) The scope to filter tasks by (all, spaces, folders, or lists)
• item_ids (array[string], optional) List of IDs to get tasks from (required for spaces/folders/lists, ignored for ‘all’)
• offset (integer, optional) Starting position for offset-based retrieval (default: 0)
• limit (integer, optional) Maximum number of tasks to return (max: 50, default: 20)
• order_by (Enum TaskOrderBy, optional) Field to sort tasks by
• should_sort_by_reverse (boolean, optional) Whether to sort in descending order (default: False)
• statuses (array[string], optional) List of status strings to filter by
• include_closed (boolean, optional) Whether to include closed tasks (default: False)
• due_date_gt (string, optional) Due date greater than (date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS])
• due_date_lt (string, optional) Due date less than (date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS])
• date_created_gt (string, optional) Created date greater than (date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS])
• date_created_lt (string, optional) Created date less than (date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS])

Clickup.GetTasksByAssignees

Get filtered tasks assigned to specific team members with advanced filtering options.

Parameters

• workspace_id (string, required) The ClickUp workspace ID for GUI URL generation (should be a number)
• assignees_ids (array[integer], required) List of assignee user IDs to get tasks for
• offset (integer, optional) Starting position for offset-based retrieval (default: 0)
• limit (integer, optional) Maximum number of tasks to return (max: 50, default: 20)
• order_by (Enum TaskOrderBy, optional) Field to sort tasks by
• should_sort_by_reverse (boolean, optional) Whether to sort in descending order (default: False)
• statuses (array[string], optional) List of status strings to filter by
• include_closed (boolean, optional) Whether to include closed tasks (default: False)
• due_date_gt (string, optional) Due date greater than (date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS])
• due_date_lt (string, optional) Due date less than (date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS])
• date_created_gt (string, optional) Created date greater than (date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS])
• date_created_lt (string, optional) Created date less than (date string in format YYYY-MM-DD or YYYY-MM-DD HH:MM[:SS])

Clickup.UpdateTaskAssignees

Update task assignees by adding and/or removing specific users.

Parameters

• task_id (string, required) The ClickUp task ID to update assignees for
• assignee_ids_to_add (array[integer], optional) List of user IDs to add as assignees
• assignee_ids_to_remove (array[integer], optional) List of user IDs to remove from assignees

Clickup.GetSpaces

Retrieve spaces from a ClickUp workspace.

Parameters

• workspace_id (string, required) The ClickUp workspace ID to get spaces from (should be a number)
• offset (integer, optional) Starting position for offset-based retrieval (default: 0)
• limit (integer, optional) Maximum number of spaces to return (max: 50, default: 50)
• include_archived (boolean, optional) Whether to include archived spaces (default: False)

Clickup.GetFoldersForSpace

Retrieve folders (also called directories, project categories, or project areas) from a

Parameters

• space_id (string, required) The ClickUp space ID to get folders from
• workspace_id (string, required) The ClickUp workspace ID for GUI URL generation (should be a number)
• offset (integer, optional) Starting position for offset-based retrieval (default: 0)
• limit (integer, optional) Maximum number of folders to return (max: 50, default: 50)
• include_archived (boolean, optional) Whether to include archived, inactive, or deleted folders (default: False)

Clickup.GetListsForFolder

Retrieve task lists from a ClickUp folder (when users refer to a folder as a “directory”,

Parameters

• folder_id (string, required) The ClickUp folder ID (also called directory ID) to get lists from
• workspace_id (string, required) The ClickUp workspace ID for GUI URL generation (should be a number)
• offset (integer, optional) Starting position for offset-based retrieval (default: 0)
• limit (integer, optional) Maximum number of lists to return (max: 50, default: 50)
• include_archived (boolean, optional) Whether to include archived, inactive, or completed lists (default: False)

Clickup.GetListsForSpace

Retrieve all task lists from a ClickUp space by collecting lists from all folders within the

Parameters

• space_id (string, required) The ClickUp space ID to get lists from
• workspace_id (string, required) The ClickUp workspace ID for GUI URL generation (should be a number)
• offset (integer, optional) Starting position for offset-based retrieval (default: 0)
• limit (integer, optional) Maximum number of lists to return (max: 50, default: 50)
• include_archived (boolean, optional) Whether to include archived, inactive, or completed lists (default: False)

Clickup.GetStatusesForList

Retrieve the possible task statuses for a specific ClickUp list.

Parameters

• list_id (string, required) The ClickUp list ID to retrieve possible task statuses for

Clickup.GetMembersForWorkspace

Retrieve all team members from a specific ClickUp workspace.

Parameters

• workspace_id (string, required) The ID of the ClickUp workspace to get team members from (should be a number)
• offset (integer, optional) Starting position for offset-based retrieval (default: 0)
• limit (integer, optional) Maximum number of members to return (max: 50, default: 50)

Clickup.WhoAmI

Return current user profile and accessible workspaces (teams).

Parameters

This tool does not take any parameters.

Clickup.GetSystemGuidance

Return static guidance intended solely to help agents make informed decisions.

Parameters

This tool does not take any parameters.

Clickup.GetWorkspaceInsights

Return a brief overview for a workspace using the latest updated tasks to inform the user.

Parameters

• workspace_id (string, required) The ClickUp workspace ID to summarize (should be a number)

Clickup.GetTaskComments

Get comments for a specific ClickUp task with pagination support.

Parameters

• task_id (string, required) The ClickUp task ID to get comments for
• limit (integer, optional) Number of comments to retrieve (max 25, default: 5)
• oldest_comment_id (string, optional) ID of the oldest comment from previous call for pagination

Clickup.CreateTaskComment

Create a new comment on a ClickUp task with optional assignment.

Parameters

• task_id (string, required) The ClickUp task ID to add a comment to
• comment_text (string, required) The text content of the comment
• assignee_id (integer, optional) User ID to assign the comment to (optional)

Clickup.UpdateTaskComment

Update an existing comment on a ClickUp task.

Parameters

• comment_id (string, required) The ClickUp comment ID to update
• task_id (string, required) The ClickUp task ID the comment belongs to
• comment_text (string, optional) New text content for the comment (optional)
• assignee_id (integer, optional) User ID to assign the comment to (optional)
• resolution (Enum CommentResolution, optional) Set comment resolution status (optional)

Clickup.FuzzySearchTasksByName

Search for tasks using fuzzy matching on task names.

Parameters

• name_to_search (string, required) Task name to search for (minimum 6 characters)
• workspace_id (string, required) The workspace ID to search tasks in (should be a number)
• scan_size (integer, optional) Number of recent tasks to scan (max 500 default: 500)
• include_closed (boolean, optional) Include closed/completed tasks (default: false)
• statuses (array[string], optional) Filter by specific ClickUp status names. Each list has its own statuses set.
• assignee_ids (array[string], optional) Filter by assignee user IDs
• space_ids (array[string], optional) Filter by ClickUp space IDs - limit search to specific spaces/teams
• folder_ids (array[string], optional) Filter by ClickUp folder IDs - limit search to specific folders/projects
• list_ids (array[string], optional) Filter by ClickUp list IDs - limit search to specific lists
• limit (integer, optional) Maximum number of matches to return (max: 50, default: 10)

Clickup.FuzzySearchListsByName

Search for lists using fuzzy matching on list names.

Parameters

• name_to_search (string, required) List name to search for (minimum 6 characters)
• workspace_id (string, required) The workspace ID to search lists in (should be a number)
• scan_size (integer, optional) Number of lists to scan (in increments of 100, max 500 default: 500)
• space_ids (array[string], optional) Filter by ClickUp space IDs - limit search to specific spaces/teams
• folder_ids (array[string], optional) Filter by ClickUp folder IDs - limit search to specific folders/projects
• should_include_archived (boolean, optional) Include archived lists (default: false)
• limit (integer, optional) Maximum number of matches to return (max: 50, default: 10)

Clickup.FuzzySearchFoldersByName

Search for folders using fuzzy matching on folder names.

Parameters

• name_to_search (string, required) Folder name to search for (minimum 6 characters)
• workspace_id (string, required) The workspace ID to search folders in (should be a number)
• scan_size (integer, optional) Number of folders to scan (in increments of 100, max 500 default: 500)
• space_ids (array[string], optional) Filter by ClickUp space IDs - limit search to specific spaces/teams
• should_include_archived (boolean, optional) Include archived folders (default: false)
• limit (integer, optional) Maximum number of matches to return (max: 50, default: 10)

Clickup.FuzzySearchMembersByName

Search for workspace members using fuzzy matching on member names.

Parameters

• name_to_search (string, required) Member name to search for (minimum 6 characters)
• workspace_id (string, required) The workspace ID to search members in (should be a number)
• scan_size (integer, optional) Number of members to scan (in increments of 100, max 500 default: 500)
• limit (integer, optional) Maximum number of matches to return (max: 50, default: 10)

Reference

Below is a reference of enumerations used by some of the tools in the Clickup toolkit:

TaskPriority

• URGENT: URGENT
• HIGH: HIGH
• NORMAL: NORMAL
• LOW: LOW

FilterScope

• ALL: all
• SPACES: spaces
• FOLDERS: folders
• LISTS: lists

TaskOrderBy

• CREATED: created
• UPDATED: updated
• DUE_DATE: due_date

CommentResolution

• SET_AS_RESOLVED: resolved
• SET_AS_UNRESOLVED: unresolved

Auth

The Arcade Clickup toolkit uses the Clickup auth provider to connect to users’ Clickup accounts. Please refer to the Clickup auth provider documentation to learn how to configure auth.

pip install arcade_clickup