ClickUp
Arcade Optimized
Arcade.dev LLM tools for interacting with ClickUp
23tools
The ClickUp toolkit integrates Arcade with ClickUp's project management platform, enabling LLM agents to read and write tasks, comments, and workspace structure through a full-featured set of tools.
Capabilities
- Workspace & hierarchy navigation — retrieve workspaces, spaces, folders, and lists; resolve current user identity and accessible workspaces as a starting point for any session.
- Task management — create, update, and retrieve tasks with full metadata support (status, priority, dates, assignees, sprint points, parent/hierarchy, custom task IDs).
- Comment & thread management — create, update, and list task comments; create and list threaded replies; assign or resolve comments.
- Fuzzy search — locate tasks, lists, folders, and workspace members by approximate name match with relevance scores, bypassing manual hierarchy traversal.
- Filtered listing & pagination — list tasks by location, assignee, status, or date range with offset-based pagination; list statuses, members, and container contents with archived-item filtering.
- Agent guidance — internal static guidance tool (
GetSystemGuidance) and workspace overview (GetWorkspaceOverview) to help agents make context-aware decisions.
OAuth
Authentication uses OAuth 2.0 via the ClickUp provider. See the Arcade ClickUp auth provider docs for setup details.
Available tools(23)
23 of 23 tools
Operations
Behavior
| Tool name | Description | Secrets | |
|---|---|---|---|
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. | |||
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. | |||
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. | |||
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 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 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. | |||
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. | |||
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 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. | |||
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. | |||
List filtered tasks from a ClickUp workspace.
Use this tool for a set of tasks chosen by where they live, who they are assigned to, their
status, or their dates, rather than for one task found by its title (name). Returns one page
of tasks and the offset of the next page. | |||
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. | |||
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 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 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). | |||
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). | |||
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. |
Last updated on