ClickUp
for LuumenAI
Tasks filed and closed with the run linked.
Keep ClickUp in sync with operational work. LuumenAI finds related issues, files follow-ups with the run linked, and updates status — every write previewed and approved first.
The ClickUp toolbox
162 tools: 63 read, 99 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadGet accessible custom fieldsRetrieves all accessible Custom Field definitions for a specified ClickUp List using its `list_id`.
- ReadGet all tags from time entriesRetrieves all unique tags applied to time entries within a specified ClickUp Team (Workspace).
- ReadGet authorized teams workspacesRetrieves a list of Workspaces (Teams) the authenticated user can access.
- ReadGet authorized userRetrieves the details of the currently authenticated ClickUp user.
- ReadGet bulk tasks time in statusRetrieves the time spent in each status for multiple tasks; requires the 'Total time in Status' ClickApp to be enabled in the Workspace.
- ReadGet chat channelRetrieves details for a specific chat channel in a ClickUp Workspace.
- ReadGet chat channel followersRetrieve followers of a ClickUp chat channel.
- ReadGet chat channel membersGet members of a chat channel.
- ReadGet chat channelsRetrieve chat channels in a ClickUp workspace.
- ReadGet chat message reactionsRetrieve reactions on a ClickUp chat message.
- ReadGet chat message repliesRetrieves replies to a chat message in ClickUp.
- ReadGet chat messagesRetrieve messages from a ClickUp chat channel.
- ReadGet chat message tagged usersRetrieve users tagged in a ClickUp chat message.
- ReadGet chat view commentsRetrieves comments from a specified Chat view in ClickUp, supporting pagination via `start` and `start_id` to fetch comments older than the default 25 most recent.
- ReadGet custom rolesRetrieves all Custom Roles, which allow granular permission configurations, for a specified Workspace (Team).
- ReadGet custom task typesRetrieves all custom task types available within a specified Workspace (team_id).
- ReadGet Doc ContentFetch the full content of a ClickUp Doc including metadata and all page contents in markdown format.
- ReadGet Doc Page ContentFetch a single ClickUp Doc page's content and metadata by workspace_id + doc_id + page_id (v3 Docs API).
- ReadGet Doc Page ListingFetch the page listing structure of a ClickUp Doc by workspace_id and doc_id.
- ReadGet Doc PagesFetch pages belonging to a ClickUp Doc.
- ReadGet filtered team tasksRetrieves a paginated list of tasks (up to 100 per page) from a specified workspace based on various filter criteria, respecting user access permissions.
- ReadGet folderRetrieves detailed information about a specific folder in ClickUp.
- ReadGet Folder Available FieldsView custom fields available in a ClickUp folder.
- ReadGet folderless listsRetrieves all Lists within a specified Space that are not located in any Folder.
- ReadGet foldersRetrieves Folders within a specified ClickUp Space, ensuring `space_id` is valid, with an option to filter by archived status.
- ReadGet folder viewsRetrieves all configured views (like List, Board, Calendar) for a specified, existing Folder in ClickUp.
- ReadGet goalRetrieves detailed information for an existing ClickUp Goal, specified by its unique `goal_id`.
- ReadGet goalsRetrieves goals for a specified ClickUp Workspace (Team); the `team_id` must be valid and accessible.
- ReadGet guestCall this to retrieve detailed information for a specific guest within a Team (Workspace), ensuring the `guest_id` is valid for the given `team_id`; this action requires the ClickUp Enterprise Plan.
- ReadGet listRetrieves detailed information for an existing List in ClickUp, identified by its unique `list_id`.
- ReadGet list commentsRetrieves comments for a specific ClickUp List, supporting pagination using `start` (timestamp) and `start_id` (comment ID) to fetch earlier comments; omits them for the latest 25.
- ReadGet list membersRetrieves all members of a specific, existing ClickUp List by its ID.
- ReadGet listsRetrieves all lists within a specified, existing ClickUp folder, optionally filtering by archived status.
- ReadGet list viewsRetrieves all task and page views for a specified and accessible ClickUp List.
- ReadGet running time entryRetrieves the currently active time entry for a user in a Workspace; a negative 'duration' in its data indicates it's running, and the response may be empty if no entry is active.
- ReadShared hierarchyRetrieves the hierarchy of tasks, Lists, and Folders shared with the authenticated user within an existing ClickUp Team (Workspace), identified by its `team_id`.
- ReadGet spaceRetrieves detailed information for an existing Space in a ClickUp Workspace, identified by its unique space_id.
- ReadGet space available fieldsRetrieves all custom fields available in a ClickUp Space, identified by space_id.
- ReadGet spacesRetrieves Spaces for a Team ID; member information for private Spaces is returned only if the authenticated user is a member.
- ReadGet space tagsRetrieves all tags for tasks within a specified ClickUp Space, requiring a valid `space_id`.
- ReadGet space viewsRetrieves all task and page views for a specified Space ID in ClickUp.
- ReadGet post subtype IDsRetrieve post subtype IDs (Announcement, Discussion, Idea, Update) for a ClickUp Workspace.
- ReadGet taskRetrieves comprehensive details for a ClickUp task by its ID, supporting standard or custom task IDs (requires `team_id` for custom IDs).
- ReadGet task commentsRetrieves up to 25 comments for a specified task, supporting pagination using `start` and `start_id` to fetch older comments.
- ReadGet task membersRetrieves users with explicit access (directly assigned or shared) to a specific existing task, excluding users with inherited permissions.
- ReadGet tasksRetrieves tasks from a specified ClickUp list; only tasks whose home is the given list_id are returned.
- ReadGet task templatesRetrieves task templates for a specified Workspace (Team ID), supporting pagination.
- ReadGet task s time in statusRetrieves the duration a task has spent in each status, provided the 'Total time in Status' ClickApp is enabled for the Workspace.
- ReadGet team available fieldsRetrieves all custom fields available in a ClickUp Workspace (Team), identified by team_id.
- ReadGet teamsRetrieves user groups (Teams) from a ClickUp Workspace, typically requiring `team_id` (Workspace ID), with an option to filter by `group_ids`.
- ReadGet threaded commentsRetrieves threaded replies to a parent comment.
- ReadGet time entries within a date rangeRetrieves time entries for a specified Team (Workspace ID) within a date range (defaults to the last 30 days for the authenticated user if dates are omitted); active timers are indicated by negative…
- ReadGet singular time entryFetches a specific time entry by its ID for a given team; a negative duration in the response indicates an active timer.
- ReadGet time entry historyRetrieves the modification history for an existing time entry within a specific ClickUp Team (Workspace).
- ReadGet tracked timeRetrieves tracked time for a task using a legacy endpoint; prefer newer Time Tracking API endpoints for managing time entries.
- ReadGet userRetrieves detailed information for a specific user within a ClickUp Workspace (Team), available only for Workspaces on the ClickUp Enterprise Plan.
- ReadGet viewFetches details for a specific ClickUp view, identified by its `view_id`, which must exist.
- ReadGet view tasksRetrieves all tasks visible in a specified ClickUp view, respecting its applied filters, sorting, and grouping.
- ReadGet webhooksFetches webhooks for a Team (Workspace), returning only those created by the authenticated user via API, for a `team_id` they can access.
- ReadGet workspace everything level viewsRetrieves all task and page views at the 'Everything Level' (a comprehensive overview of all tasks across all Spaces) for a specified ClickUp Workspace.
- ReadGet workspace planRetrieves the details of the current subscription plan for a specified ClickUp Workspace.
- ReadGet workspace seatsRetrieves seat utilization (used, total, available for members/guests) for a ClickUp Workspace (Team) ID, which must be for an existing Workspace.
- ReadSearch DocsSearch and list Docs metadata in a ClickUp workspace.
- WriteAdd dependencyAdds a 'waiting on' or 'blocking' dependency to a task, requiring either `depends_on` (task becomes waiting on) or `dependency_of` (task becomes blocking), but not both; `team_id` is required if… Approval by default
- WriteAdd guest to folderAdds a guest to a folder with specified permissions; requires a ClickUp Enterprise Plan. Approval by default
- WriteAdd guest to listShares a ClickUp List with an existing guest user, granting them specified permissions; requires the Workspace to be on the ClickUp Enterprise Plan. Approval by default
- WriteAdd guest to taskAssigns a guest to a task with specified permissions; requires ClickUp Enterprise Plan, and `team_id` if `custom_task_ids` is true. Approval by default
- WriteAdd tags from time entriesAssociates a list of specified tags with one or more time entries within a given Team (Workspace). Approval by default
- WriteAdd tag to taskAdds an existing tag to a specified task; team_id is required if custom_task_ids is true. Approval by default
- WriteAdd task linkLinks two existing and accessible ClickUp tasks, identified by `task_id` (source) and `links_to` (target). Approval by default
- WriteAdd task to listAdds an existing task to an additional ClickUp List; the "Tasks in Multiple Lists" ClickApp must be enabled in the Workspace for this. Approval by default
- WriteUpdate Doc PageUpdate/edit a ClickUp Doc page's title and/or content via the v3 Docs API. Approval by default
- WriteCreate a time entryCreates a new time entry for a specified team. Approval by default
- WriteCreate chat channelCreate a chat channel in a ClickUp workspace. Approval by default
- WriteCreate chat messageSend a message in a ClickUp chat channel. Approval by default
- WriteCreate chat reactionAdd a reaction to a ClickUp chat message. Approval by default
- WriteCreate chat view commentPosts a new comment to a specified ClickUp Chat view; the 'view_id' must correspond to an existing and accessible Chat view. Approval by default
- WriteCreate checklistCreates a new checklist with a specified name within an existing task, which can be identified by its standard ID or a custom task ID (if `custom_task_ids` is true, `team_id` is also required). Approval by default
- WriteCreate checklist itemCreates a new checklist item within a specified, existing checklist, optionally setting the item's name and assigning it to a user. Approval by default
- WriteCreate direct message channelCreate a direct message channel in ClickUp. Approval by default
- WriteCreate DocCreate a new ClickUp Doc in a Workspace (v3 Docs API) and return the new doc_id for follow-up page/content operations. Approval by default
- WriteCreate Doc PageCreate a page in a ClickUp Doc (v3 Docs API). Approval by default
- WriteCreate folderCreates a new ClickUp Folder within the specified Space, which must exist and be accessible. Approval by default
- WriteCreate folderless listCreates a new folderless list (a list not part of any Folder) directly within a specified ClickUp Space. Approval by default
- WriteCreate folder viewCreates a new, highly customizable view within a specific ClickUp folder using its `folder_id`. Approval by default
- WriteCreate goalCreates a new goal in a ClickUp Team (Workspace). Approval by default
- WriteCreate key resultCreates a new Key Result (Target) for a specified Goal in ClickUp to define and track measurable objectives towards achieving that Goal. Approval by default
- WriteCreate listCreates a new list in ClickUp within an existing folder. Approval by default
- WriteCreate list commentAdds a new comment with specific text to an existing and accessible ClickUp List, assigns it to a user, and sets notification preferences for all list members. Approval by default
- WriteCreate list from template in folderCreates a new list from a template in a specified ClickUp folder. Approval by default
- WriteCreate list viewCreates a new, customizable view (e.g., list, board, calendar) within a specified ClickUp List, requiring an existing list_id accessible by the user. Approval by default
- WriteCreate Location Chat ChannelCreate a Channel on a Space, Folder, or List in ClickUp. Approval by default
- WriteCreate reply messageCreate a reply to a chat message in ClickUp. Approval by default
- WriteCreate spaceCreates a new ClickUp Space within a specified Workspace, allowing feature configuration which defaults to Workspace settings if unspecified. Approval by default
- WriteCreate space tagCreates a new tag (name, foreground color, background color) in an existing ClickUp Space. Approval by default
- WriteCreate space viewCreates a customizable view (e.g., List, Board, Gantt) within a specified ClickUp Space, allowing configuration of grouping, sorting, filtering, and display settings. Approval by default
- WriteCreate a taskCreates a new ClickUp task in a specific list, optionally as a subtask if a `parent` task ID (which cannot be a subtask itself and must be in the same list) is provided. Approval by default
- WriteCreate task attachmentUploads a file as an attachment to a specified ClickUp task using multipart/form-data. Approval by default
- WriteCreate task commentAdds a comment to a ClickUp task; `team_id` is required if `custom_task_ids` is true. Approval by default
- WriteCreate task from templateCreates a new task in a specified ClickUp list from a task template, using the provided name for the new task. Approval by default
- WriteCreate teamCreates a new team (user group) with specified members in a Workspace; member IDs must be for existing users, and be aware that adding view-only guests as paid members may incur extra charges. Approval by default
- WriteCreate threaded commentCreate a threaded reply to a comment in ClickUp. Approval by default
- WriteCreate webhookCreates a ClickUp webhook for a Team (Workspace) to notify a public URL on specified events (at least one, or '*' for all), optionally scoped to a Space, Folder, List, or Task; the endpoint must… Approval by default
- WriteCreate workspace Everything level viewCreates a new, customizable view (e.g., List, Board) at the 'Everything' level for a specified Team (Workspace ID), encompassing all tasks within that Workspace. Approval by default
- WriteDelete chat channelDelete a chat channel in ClickUp. Approval by default
- WriteDelete chat messageDelete a chat message in ClickUp. Approval by default
- WriteDelete chat reactionDelete a reaction from a chat message in ClickUp. Approval by default
- WriteDelete checklistPermanently deletes an existing checklist identified by its `checklist_id`. Approval by default
- WriteDelete checklist itemPermanently deletes an existing item, identified by `checklist_item_id`, from an existing checklist, identified by `checklist_id`. Approval by default
- WriteDelete commentDeletes an existing comment from a task using its `comment_id`. Approval by default
- WriteDelete dependencyRemoves a dependency relationship for a task. Approval by default
- WriteDelete folderPermanently and irreversibly deletes a specified folder and all its contents (Lists, Tasks) if the folder_id exists. Approval by default
- WriteDelete goalPermanently removes an existing Goal, identified by its `goal_id`, from the Workspace. Approval by default
- WriteDelete key resultDeletes an existing Key Result, also referred to as a Target within a Goal, identified by its `key_result_id`. Approval by default
- WriteDelete listPermanently deletes an existing List and all its contents; this action is destructive and irreversible via the API. Approval by default
- WriteDelete spacePermanently deletes a specified Space in ClickUp; this action is irreversible as the Space cannot be recovered via the API. Approval by default
- WriteDelete space tagDeletes a Tag from a Space, identified by `tag_name` in path; precise matching of Tag details in the request body (`tag_name_1`, `tag_tag_fg`, `tag_tag_bg`) is generally required for successful… Approval by default
- WriteDelete taskPermanently deletes a task, using its standard ID or a custom task ID (requires `custom_task_ids=true` and `team_id`). Approval by default
- WriteDelete task linkDeletes an existing link, effectively a dependency or relationship, between two ClickUp tasks; set `custom_task_ids=true` and provide `team_id` if using custom task IDs. Approval by default
- WriteDelete teamPermanently deletes an existing Team (user group) from the Workspace using its `group_id`. Approval by default
- WriteDelete a time entryDeletes an existing time entry, specified by `timer_id`, from a Workspace identified by `team_id`. Approval by default
- WriteDelete time trackedDeletes a time-tracked interval from a task; use this legacy endpoint for older time tracking systems. Approval by default
- WriteDelete viewPermanently and irreversibly deletes an existing View in ClickUp, identified by its `view_id`. Approval by default
- WriteDelete webhookPermanently removes an existing webhook, specified by its ID, thereby ceasing all its event monitoring and notifications. Approval by default
- WriteGet access tokenExchanges a ClickUp OAuth 2.0 authorization code (obtained after user consent) for an access token. Approval by default
- WriteInvite guest to workspaceInvites a guest by email to a ClickUp Workspace (Team) on an Enterprise Plan, setting initial permissions and optionally a custom role; further access configuration for specific items may require… Approval by default
- WriteInvite user to workspaceInvites a user via email to a ClickUp Workspace (Team), optionally granting admin rights or a custom role; requires an Enterprise Plan for the Workspace. Approval by default
- WriteMove task to new home listMove a task to a new home List using ClickUp Public API v3. Approval by default
- WriteRemove custom field valueRemoves an existing value from a Custom Field on a specific task; this does not delete the Custom Field definition or its predefined options. Approval by default
- WriteRemove guest from folderRevokes a guest's access to a specific ClickUp Folder, optionally unsharing items explicitly shared with them within it; requires an Enterprise Plan. Approval by default
- WriteRemove guest from listRevokes a guest's access to a specific List, provided the guest currently has access to this List and the Workspace is on the ClickUp Enterprise Plan. Approval by default
- WriteRemove guest from taskRevokes a guest's access to a specific task; only available for Workspaces on the ClickUp Enterprise Plan. Approval by default
- WriteRemove guest from workspacePermanently removes a guest from a specified Workspace, revoking all their access; this destructive operation requires the Workspace to be on the ClickUp Enterprise Plan. Approval by default
- WriteRemove tag from taskRemoves a tag from a specified task by disassociating it (does not delete the tag from Workspace), succeeding even if the tag is not on the task. Approval by default
- WriteRemove tags from time entriesRemoves tags from specified time entries in a team, without deleting the tags from the workspace. Approval by default
- WriteRemove task from listRemoves a task from an extra list (not its home list); the 'Tasks in Multiple Lists' ClickApp must be enabled. Approval by default
- WriteRemove user from workspaceDeactivates a user from a specified ClickUp Workspace, revoking their access (user can be reactivated later); requires the Workspace to be on an Enterprise Plan. Approval by default
- WriteSet custom field valueSets or updates a Custom Field's value for a task; the new value (with type-dependent structure, e.g., `{"value": "text"}` or `{"value": 123, "value_options": {"currency_type":"USD"}}`) is provided… Approval by default
- WriteStart a time entryStarts a new time entry (timer) in the specified Team (Workspace), optionally associating it with a task, adding a description, setting billable status, or applying tags (tags feature requires… Approval by default
- WriteStop a time entryStops the authenticated user's currently active time entry in the specified Team (Workspace), which requires an existing time entry to be running. Approval by default
- WriteTrack timeRecords a time entry for a task using ClickUp's legacy time tracking system; newer endpoints are generally recommended. Approval by default
- WriteUpdate chat channelUpdate a ClickUp chat channel's properties including name, topic, description, visibility, and location. Approval by default
- WriteUpdate chat messageUpdate a ClickUp chat message's content, assignee, or resolved status via the v3 API. Approval by default
- WriteEdit checklistUpdates an existing checklist's name or position, identified by its `checklist_id`. Approval by default
- WriteEdit checklist itemUpdates an existing checklist item, allowing modification of its name, assignee, resolution status, or parent item for nesting. Approval by default
- WriteUpdate commentUpdates an existing task comment's text, assignee (who must be a valid workspace member), or resolution status, requiring a valid existing comment_id. Approval by default
- WriteUpdate folderUpdates the name of an existing folder in ClickUp. Approval by default
- WriteUpdate goalUpdates attributes of an existing ClickUp goal, identified by its `goal_id`. Approval by default
- WriteEdit guest on workspaceModifies the details and permissions of an existing guest user within a specific Workspace. Approval by default
- WriteEdit key resultUpdates an existing key result's progress or note in ClickUp, where the key result measures progress towards a goal. Approval by default
- WriteUpdate listUpdates attributes of an existing ClickUp list, such as its name, content, due date, priority, assignee, or color status, identified by its `list_id`. Approval by default
- WriteUpdate spaceUpdates an existing ClickUp Space, allowing modification of its name, color, privacy, and feature settings (ClickApps). Approval by default
- WriteEdit space tagUpdates an existing tag's name and colors in a ClickUp Space; requires current tag name for identification, and new values for tag name, foreground color, and background color, all of which are… Approval by default
- WriteUpdate taskUpdates attributes of an existing task; `team_id` is required if `custom_task_ids` is true, use a single space (" ") for `description` to clear it, and provide at least one modifiable field. Approval by default
- WriteUpdate teamUpdates an existing ClickUp User Group (Team) using its `group_id`; note that adding a view-only guest as a paid member may incur charges. Approval by default
- WriteUpdate a time entryUpdates an existing ClickUp time entry. Approval by default
- WriteChange tag names from time entriesUpdates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team_id`. Approval by default
- WriteEdit time trackedEdits a legacy time-tracked interval for a task (identified by `task_id` and `interval_id`) to update its start/end times and duration; `team_id` is required if `custom_task_ids` is true. Approval by default
- WriteEdit user on workspaceUpdates a user's username, admin status, or custom role in a Workspace; requires the Workspace to be on an Enterprise Plan. Approval by default
- WriteUpdate viewUpdates an existing ClickUp view's settings such as name, type, grouping, or filters; ensure `parent_id` and `parent_type` define a valid hierarchy, and that specified field names (e.g. Approval by default
- WriteUpdate webhookUpdates the endpoint URL, monitored events, and status of an existing webhook, identified by its `webhook_id`. Approval by default
- WriteUpdate workspace ACLUpdates privacy and access control list (ACL) permissions for a workspace object or location. Approval by default
One prompt, start to finish
What a governed ClickUp run looks like inside Luumen.
Questions
How does LuumenAI connect to ClickUp?
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in ClickUp on its own?
Read actions answer immediately. Anything that writes — add dependency, add guest to folder, add guest to list, add guest to task, and more — is shown as a plan and requires approval by default, including the 28 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to ClickUp — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Put ClickUp to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.