Smithery's MCP Proxy and managed identity shut down on October 31. See what's changing

SmitherySign up for Arcade

ClickUp

Arcade toolkit · docs.arcade.dev

The ClickUp toolkit connects LLM agents to ClickUp via Arcade, enabling full read/write interaction with workspaces, spaces, folders, lists, tasks, comments, and team members.

Capabilities

  • Workspace & hierarchy navigation — Retrieve workspaces, spaces, folders, and lists; get workspace members and high-level insights; resolve the authenticated user's identity and available workspaces as a first step.
  • Task lifecycle management — Create tasks with status, priority, scheduling, and hierarchy metadata; update any combination of task fields (title, description, status, priority, dates, parent, sprint points); manage assignees with add/remove operations.
  • Filtered task retrieval — Query tasks by scope (space, folder, or list), by assignee(s), or by task ID (including custom IDs), with date-range and status filtering.
  • Comments & threads — Create, read, and update top-level task comments; create and read threaded replies; optionally assign comments or replies for follow-up; paginate both comment and reply sets.
  • Fuzzy search — Locate tasks, lists, folders, and workspace members by approximate name when exact IDs or locations are unknown; results include relevance scores (1.0 = exact match).
  • Agent guidance — Internal static guidance tool (GetSystemGuidance) helps agents make context-aware decisions without surfacing content to end users.

Tools24

  • Clickup_CreateTask

    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.

  • Clickup_CreateTaskComment

    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.

  • Clickup_CreateTaskCommentReply

    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.

  • Clickup_FuzzySearchFoldersByName

    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).

  • Clickup_FuzzySearchListsByName

    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).

  • Clickup_FuzzySearchMembersByName

    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).

  • Clickup_FuzzySearchTasksByName

    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).

  • Clickup_GetFoldersForSpace

    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.

  • Clickup_GetListsForFolder

    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.

  • Clickup_GetListsForSpace

    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.

  • Clickup_GetMembersForWorkspace

    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.

  • Clickup_GetSpaces

    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.

  • Clickup_GetStatusesForList

    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.

  • Clickup_GetSystemGuidance

    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.

  • Clickup_GetTaskById

    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.

  • Clickup_GetTaskCommentReplies

    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.

  • Clickup_GetTaskComments

    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.

  • Clickup_GetTasksByAssignees

    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).

  • Clickup_GetTasksByScope

    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).

  • Clickup_GetWorkspaceInsights

    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.

  • Clickup_UpdateTask

    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.

  • Clickup_UpdateTaskAssignees

    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.

  • Clickup_UpdateTaskComment

    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.

  • Clickup_WhoAmI

    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.