# ClickUp

ClickUp unifies tasks, docs, goals, and chat in a single platform, allowing teams to plan, organize, and collaborate across projects with customizable workflows

- **Category:** productivity
- **Auth:** OAUTH2, API_KEY
- **Composio Managed App Available?** Yes
- **Tools:** 164
- **Triggers:** 0
- **Slug:** `CLICKUP`
- **Version:** 20260506_00

## Tools

### Add dependency

**Slug:** `CLICKUP_ADD_DEPENDENCY`

Adds 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 `custom_task_ids` is true.

### Add guest to folder

**Slug:** `CLICKUP_ADD_GUEST_TO_FOLDER`

Adds a guest to a folder with specified permissions; requires a ClickUp Enterprise Plan.

### Add guest to list

**Slug:** `CLICKUP_ADD_GUEST_TO_LIST`

Shares a ClickUp List with an existing guest user, granting them specified permissions; requires the Workspace to be on the ClickUp Enterprise Plan.

### Add guest to task

**Slug:** `CLICKUP_ADD_GUEST_TO_TASK`

Assigns a guest to a task with specified permissions; requires ClickUp Enterprise Plan, and `team_id` if `custom_task_ids` is true.

### Add tags from time entries

**Slug:** `CLICKUP_ADD_TAGS_TO_TIME_ENTRIES`

Associates a list of specified tags with one or more time entries within a given Team (Workspace).

### Add tag to task

**Slug:** `CLICKUP_ADD_TAG_TO_TASK`

Adds an existing tag to a specified task; team_id is required if custom_task_ids is true.

### Add task link

**Slug:** `CLICKUP_ADD_TASK_LINK`

Links two existing and accessible ClickUp tasks, identified by `task_id` (source) and `links_to` (target).

### Add task to list

**Slug:** `CLICKUP_ADD_TASK_TO_LIST`

Adds an existing task to an additional ClickUp List; the "Tasks in Multiple Lists" ClickApp must be enabled in the Workspace for this.

### Create task attachment

**Slug:** `CLICKUP_ATTACHMENTS_UPLOAD_FILE_TO_TASK_AS_ATTACHMENT`

DEPRECATED: Use `create_task_attachment` to upload a file to a task; requires `multipart/form-data`.

### Get authorized teams workspaces

**Slug:** `CLICKUP_AUTHORIZATION_GET_WORK_SPACE_LIST`

DEPRECATED: Use `get_authorized_teams_workspaces` instead to retrieve Workspaces (Teams) accessible to the authenticated user.

### Update Doc Page

**Slug:** `CLICKUP_CLICK_UP_UPDATE_DOC_PAGE`

Tool to update/edit a ClickUp Doc page's title and/or content via the v3 Docs API. Use when you need to modify a Doc page's name or content programmatically.

### Create a time entry

**Slug:** `CLICKUP_CREATE_A_TIME_ENTRY`

Creates a new time entry for a specified team.

### Create chat channel

**Slug:** `CLICKUP_CREATE_CHAT_CHANNEL`

Tool to create a chat channel in a ClickUp workspace. Use when you need to set up a new communication channel for team collaboration with configurable visibility.

### Create chat message

**Slug:** `CLICKUP_CREATE_CHAT_MESSAGE`

Tool to send a message in a ClickUp chat channel. Use when you need to post messages to team chat channels. Supports both regular messages and structured posts with optional assignments, followers, and reactions.

### Create chat reaction

**Slug:** `CLICKUP_CREATE_CHAT_REACTION`

Tool to add a reaction to a ClickUp chat message. Use when you need to react to a message with an emoji.

### Create chat view comment

**Slug:** `CLICKUP_CREATE_CHAT_VIEW_COMMENT`

Posts a new comment to a specified ClickUp Chat view; the 'view_id' must correspond to an existing and accessible Chat view.

### Create checklist

**Slug:** `CLICKUP_CREATE_CHECKLIST`

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

### Create checklist item

**Slug:** `CLICKUP_CREATE_CHECKLIST_ITEM`

Creates a new checklist item within a specified, existing checklist, optionally setting the item's name and assigning it to a user.

### Create direct message channel

**Slug:** `CLICKUP_CREATE_DIRECT_MESSAGE_CHANNEL`

Tool to create a direct message channel in ClickUp. Use when you need to start a direct message conversation with up to 15 users. A Self DM is created when no user IDs are provided.

### Create Doc

**Slug:** `CLICKUP_CREATE_DOC`

Tool to create a new ClickUp Doc in a Workspace (v3 Docs API) and return the new doc_id for follow-up page/content operations. Use when you need to create a new document in ClickUp.

### Create Doc Page

**Slug:** `CLICKUP_CREATE_DOC_PAGE`

Tool to create a page in a ClickUp Doc (v3 Docs API). Use when you need to add a new page to an existing document, either as a root page or as a sub-page under a parent page.

### Create folder

**Slug:** `CLICKUP_CREATE_FOLDER`

Creates a new ClickUp Folder within the specified Space, which must exist and be accessible.

### Create folderless list

**Slug:** `CLICKUP_CREATE_FOLDERLESS_LIST`

Creates a new folderless list (a list not part of any Folder) directly within a specified ClickUp Space.

### Create folder view

**Slug:** `CLICKUP_CREATE_FOLDER_VIEW`

Creates a new, highly customizable view within a specific ClickUp folder using its `folder_id`.

### Create goal

**Slug:** `CLICKUP_CREATE_GOAL`

Creates a new goal in a ClickUp Team (Workspace).

### Create key result

**Slug:** `CLICKUP_CREATE_KEY_RESULT`

Creates a new Key Result (Target) for a specified Goal in ClickUp to define and track measurable objectives towards achieving that Goal.

### Create list

**Slug:** `CLICKUP_CREATE_LIST`

Creates a new list in ClickUp within an existing folder. This action requires a folder_id - lists cannot be created directly in a Space using this action. If you need to create a list directly in a Space (without placing it in a folder), use the 'CLICKUP_CREATE_FOLDERLESS_LIST' action with space_id instead.

### Create list comment

**Slug:** `CLICKUP_CREATE_LIST_COMMENT`

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

### Create list from template in folder

**Slug:** `CLICKUP_CREATE_LIST_FROM_TEMPLATE`

Creates a new list from a template in a specified ClickUp folder. Use this when you need to instantiate a list based on an existing template within a folder structure.

### Create list view

**Slug:** `CLICKUP_CREATE_LIST_VIEW`

Creates a new, customizable view (e.g., list, board, calendar) within a specified ClickUp List, requiring an existing list_id accessible by the user.

### Create Location Chat Channel

**Slug:** `CLICKUP_CREATE_LOCATION_CHAT_CHANNEL`

Tool to create a Channel on a Space, Folder, or List in ClickUp. Use when you need to create a location-based chat channel.

### Create reply message

**Slug:** `CLICKUP_CREATE_REPLY_MESSAGE`

Tool to create a reply to a chat message in ClickUp. Use when replying to an existing chat message. Requires workspace_id, message_id, type, and content.

### Create space

**Slug:** `CLICKUP_CREATE_SPACE`

Creates a new ClickUp Space within a specified Workspace, allowing feature configuration which defaults to Workspace settings if unspecified.

### Create space tag

**Slug:** `CLICKUP_CREATE_SPACE_TAG`

Creates a new tag (name, foreground color, background color) in an existing ClickUp Space.

### Create space view

**Slug:** `CLICKUP_CREATE_SPACE_VIEW`

Creates a customizable view (e.g., List, Board, Gantt) within a specified ClickUp Space, allowing configuration of grouping, sorting, filtering, and display settings.

### Create a task

**Slug:** `CLICKUP_CREATE_TASK`

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

### Create task attachment

**Slug:** `CLICKUP_CREATE_TASK_ATTACHMENT`

Uploads a file as an attachment to a specified ClickUp task using multipart/form-data.

### Create task comment

**Slug:** `CLICKUP_CREATE_TASK_COMMENT`

Adds a comment to a ClickUp task; `team_id` is required if `custom_task_ids` is true.

### Create task from template

**Slug:** `CLICKUP_CREATE_TASK_FROM_TEMPLATE`

Creates a new task in a specified ClickUp list from a task template, using the provided name for the new task.

### Create team

**Slug:** `CLICKUP_CREATE_TEAM`

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

### Create threaded comment

**Slug:** `CLICKUP_CREATE_THREADED_COMMENT`

Tool to create a threaded reply to a comment in ClickUp. Use when you need to respond to an existing comment with context.

### Create webhook

**Slug:** `CLICKUP_CREATE_WEBHOOK`

Creates 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 accept requests from dynamic IPs.

### Create workspace Everything level view

**Slug:** `CLICKUP_CREATE_WORKSPACE_EVERYTHING_LEVEL_VIEW`

Creates a new, customizable view (e.g., List, Board) at the 'Everything' level for a specified Team (Workspace ID), encompassing all tasks within that Workspace.

### Delete chat channel

**Slug:** `CLICKUP_DELETE_CHAT_CHANNEL`

Tool to delete a chat channel in ClickUp. Use when you need to permanently remove a chat channel from a workspace.

### Delete chat message

**Slug:** `CLICKUP_DELETE_CHAT_MESSAGE`

Tool to delete a chat message in ClickUp. Use when you need to permanently remove a specific message from a workspace chat.

### Delete chat reaction

**Slug:** `CLICKUP_DELETE_CHAT_REACTION`

Tool to delete a reaction from a chat message in ClickUp. Use when you need to remove an emoji reaction that was previously added to a chat message.

### Delete checklist

**Slug:** `CLICKUP_DELETE_CHECKLIST`

Permanently deletes an existing checklist identified by its `checklist_id`.

### Delete checklist item

**Slug:** `CLICKUP_DELETE_CHECKLIST_ITEM`

Permanently deletes an existing item, identified by `checklist_item_id`, from an existing checklist, identified by `checklist_id`.

### Delete comment

**Slug:** `CLICKUP_DELETE_COMMENT`

Deletes an existing comment from a task using its `comment_id`.

### Delete dependency

**Slug:** `CLICKUP_DELETE_DEPENDENCY`

Removes a dependency relationship for a task. Provide exactly one of: `depends_on` to remove a 'waiting on' dependency (task_id is blocked by another task), or `dependency_of` to remove a 'blocking' dependency (another task is blocked by task_id). `team_id` is required if `custom_task_ids` is true.

### Delete folder

**Slug:** `CLICKUP_DELETE_FOLDER`

Permanently and irreversibly deletes a specified folder and all its contents (Lists, Tasks) if the folder_id exists.

### Delete goal

**Slug:** `CLICKUP_DELETE_GOAL`

Permanently removes an existing Goal, identified by its `goal_id`, from the Workspace.

### Delete key result

**Slug:** `CLICKUP_DELETE_KEY_RESULT`

Deletes an existing Key Result, also referred to as a Target within a Goal, identified by its `key_result_id`.

### Delete list

**Slug:** `CLICKUP_DELETE_LIST`

Permanently deletes an existing List and all its contents; this action is destructive and irreversible via the API.

### Delete space

**Slug:** `CLICKUP_DELETE_SPACE`

Permanently deletes a specified Space in ClickUp; this action is irreversible as the Space cannot be recovered via the API.

### Delete space tag

**Slug:** `CLICKUP_DELETE_SPACE_TAG`

Deletes 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 deletion.

### Delete task

**Slug:** `CLICKUP_DELETE_TASK`

Permanently deletes a task, using its standard ID or a custom task ID (requires `custom_task_ids=true` and `team_id`).

### Delete task link

**Slug:** `CLICKUP_DELETE_TASK_LINK`

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

### Delete team

**Slug:** `CLICKUP_DELETE_TEAM`

Permanently deletes an existing Team (user group) from the Workspace using its `group_id`.

### Delete a time entry

**Slug:** `CLICKUP_DELETE_TIME_ENTRY`

Deletes an existing time entry, specified by `timer_id`, from a Workspace identified by `team_id`.

### Delete time tracked

**Slug:** `CLICKUP_DELETE_TIME_TRACKED`

Deletes a time-tracked interval from a task; use this legacy endpoint for older time tracking systems.

### Delete view

**Slug:** `CLICKUP_DELETE_VIEW`

Permanently and irreversibly deletes an existing View in ClickUp, identified by its `view_id`.

### Delete webhook

**Slug:** `CLICKUP_DELETE_WEBHOOK`

Permanently removes an existing webhook, specified by its ID, thereby ceasing all its event monitoring and notifications.

### Get accessible custom fields

**Slug:** `CLICKUP_GET_ACCESSIBLE_CUSTOM_FIELDS`

Retrieves all accessible Custom Field definitions for a specified ClickUp List using its `list_id`.

### Get access token

**Slug:** `CLICKUP_GET_ACCESS_TOKEN`

Exchanges a ClickUp OAuth 2.0 authorization code (obtained after user consent) for an access token.

### Get all tags from time entries

**Slug:** `CLICKUP_GET_ALL_TAGS_FROM_TIME_ENTRIES`

Retrieves all unique tags applied to time entries within a specified ClickUp Team (Workspace).

### Get authorized teams workspaces

**Slug:** `CLICKUP_GET_AUTHORIZED_TEAMS_WORKSPACES`

Retrieves a list of Workspaces (Teams) the authenticated user can access.

### Get authorized user

**Slug:** `CLICKUP_GET_AUTHORIZED_USER`

Retrieves the details of the currently authenticated ClickUp user.

### Get bulk tasks time in status

**Slug:** `CLICKUP_GET_BULK_TASKS_TIME_IN_STATUS`

Retrieves the time spent in each status for multiple tasks; requires the 'Total time in Status' ClickApp to be enabled in the Workspace.

### Get chat channel

**Slug:** `CLICKUP_GET_CHAT_CHANNEL`

Retrieves details for a specific chat channel in a ClickUp Workspace. Use when you need information about a particular chat channel.

### Get chat channel followers

**Slug:** `CLICKUP_GET_CHAT_CHANNEL_FOLLOWERS`

Tool to retrieve followers of a ClickUp chat channel. Use when you need to list users following a specific channel in a workspace.

### Get chat channel members

**Slug:** `CLICKUP_GET_CHAT_CHANNEL_MEMBERS`

Tool to get members of a chat channel. Use when you need to retrieve the list of members in a specific ClickUp chat channel.

### Get chat channels

**Slug:** `CLICKUP_GET_CHAT_CHANNELS`

Tool to retrieve chat channels in a ClickUp workspace. Use when you need to list available chat channels, DMs, or group chats in a workspace. Supports pagination via cursor and filtering by follower status, closed channels, and recent activity.

### Get chat message reactions

**Slug:** `CLICKUP_GET_CHAT_MESSAGE_REACTIONS`

Tool to retrieve reactions on a ClickUp chat message. Use when you need to see who reacted to a message and with what emoji.

### Get chat message replies

**Slug:** `CLICKUP_GET_CHAT_MESSAGE_REPLIES`

Retrieves replies to a chat message in ClickUp. Use when you need to fetch responses to a specific message in a workspace chat.

### Get chat messages

**Slug:** `CLICKUP_GET_CHAT_MESSAGES`

Tool to retrieve messages from a ClickUp chat channel. Use when you need to fetch chat messages for a specific channel within a workspace.

### Get chat message tagged users

**Slug:** `CLICKUP_GET_CHAT_MESSAGE_TAGGED_USERS`

Tool to retrieve users tagged in a ClickUp chat message. Use when you need to get a list of users mentioned in a specific chat message.

### Get chat view comments

**Slug:** `CLICKUP_GET_CHAT_VIEW_COMMENTS`

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

### Get custom roles

**Slug:** `CLICKUP_GET_CUSTOM_ROLES`

Retrieves all Custom Roles, which allow granular permission configurations, for a specified Workspace (Team).

### Get custom task types

**Slug:** `CLICKUP_GET_CUSTOM_TASK_TYPES`

Retrieves all custom task types available within a specified Workspace (team_id).

### Get Doc Content

**Slug:** `CLICKUP_GET_DOC_CONTENT`

Tool to fetch the full content of a ClickUp Doc including metadata and all page contents in markdown format. Use when you need to read or summarize a Doc's content given workspace_id and doc_id.

### Get Doc Page Content

**Slug:** `CLICKUP_GET_DOC_PAGE_CONTENT`

Tool to fetch a single ClickUp Doc page's content and metadata by workspace_id + doc_id + page_id (v3 Docs API). Use when you need to read the content of a specific page without fetching the entire Doc.

### Get Doc Page Listing

**Slug:** `CLICKUP_GET_DOC_PAGE_LISTING`

Tool to fetch the page listing structure of a ClickUp Doc by workspace_id and doc_id. Use when you need to discover the hierarchical structure of pages and subpages within a Doc without fetching the actual content.

### Get Doc Pages

**Slug:** `CLICKUP_GET_DOC_PAGES_PUBLIC`

Tool to fetch pages belonging to a ClickUp Doc. Use when you need to list all pages in a doc with their content and structure.

### Get filtered team tasks

**Slug:** `CLICKUP_GET_FILTERED_TEAM_TASKS`

Retrieves a paginated list of tasks (up to 100 per page) from a specified workspace based on various filter criteria, respecting user access permissions. Unexpectedly missing tasks may indicate permission restrictions rather than filter issues. Task comments are not included; use CLICKUP_GET_TASK_COMMENTS for complete context. No keyword/text search is supported; filter client-side on returned results.

### Get folder

**Slug:** `CLICKUP_GET_FOLDER`

Retrieves detailed information about a specific folder in ClickUp.

### Get Folder Available Fields

**Slug:** `CLICKUP_GET_FOLDER_AVAILABLE_FIELDS`

Tool to view custom fields available in a ClickUp folder. Use to discover what custom fields can be used when working with tasks in this folder. Only returns folder-level custom fields, not list-level fields.

### Get folderless lists

**Slug:** `CLICKUP_GET_FOLDERLESS_LISTS`

Retrieves all Lists within a specified Space that are not located in any Folder.

### Get folders

**Slug:** `CLICKUP_GET_FOLDERS`

Retrieves Folders within a specified ClickUp Space, ensuring `space_id` is valid, with an option to filter by archived status.

### Get folder views

**Slug:** `CLICKUP_GET_FOLDER_VIEWS`

Retrieves all configured views (like List, Board, Calendar) for a specified, existing Folder in ClickUp.

### Get goal

**Slug:** `CLICKUP_GET_GOAL`

Retrieves detailed information for an existing ClickUp Goal, specified by its unique `goal_id`.

### Get goals

**Slug:** `CLICKUP_GET_GOALS`

Retrieves goals for a specified ClickUp Workspace (Team); the `team_id` must be valid and accessible.

### Get guest

**Slug:** `CLICKUP_GET_GUEST`

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

### Get list

**Slug:** `CLICKUP_GET_LIST`

Retrieves detailed information for an existing List in ClickUp, identified by its unique `list_id`.

### Get list comments

**Slug:** `CLICKUP_GET_LIST_COMMENTS`

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

### Get list members

**Slug:** `CLICKUP_GET_LIST_MEMBERS`

Retrieves all members of a specific, existing ClickUp List by its ID.

### Get lists

**Slug:** `CLICKUP_GET_LISTS`

Retrieves all lists within a specified, existing ClickUp folder, optionally filtering by archived status.

### Get list views

**Slug:** `CLICKUP_GET_LIST_VIEWS`

Retrieves all task and page views for a specified and accessible ClickUp List.

### Get running time entry

**Slug:** `CLICKUP_GET_RUNNING_TIME_ENTRY`

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

### Shared hierarchy

**Slug:** `CLICKUP_GET_SHARED_HIERARCHY`

Retrieves the hierarchy of tasks, Lists, and Folders shared with the authenticated user within an existing ClickUp Team (Workspace), identified by its `team_id`.

### Get space

**Slug:** `CLICKUP_GET_SPACE`

Retrieves detailed information for an existing Space in a ClickUp Workspace, identified by its unique space_id.

### Get space available fields

**Slug:** `CLICKUP_GET_SPACE_AVAILABLE_FIELDS`

Retrieves all custom fields available in a ClickUp Space, identified by space_id. Returns Space-level custom fields only.

### Get spaces

**Slug:** `CLICKUP_GET_SPACES`

Retrieves Spaces for a Team ID; member information for private Spaces is returned only if the authenticated user is a member.

### Get space tags

**Slug:** `CLICKUP_GET_SPACE_TAGS`

Retrieves all tags for tasks within a specified ClickUp Space, requiring a valid `space_id`.

### Get space views

**Slug:** `CLICKUP_GET_SPACE_VIEWS`

Retrieves all task and page views for a specified Space ID in ClickUp.

### Get post subtype IDs

**Slug:** `CLICKUP_GET_SUBTYPES`

Tool to retrieve post subtype IDs (Announcement, Discussion, Idea, Update) for a ClickUp Workspace. Use when you need subtype IDs to send messages with type: post.

### Get task

**Slug:** `CLICKUP_GET_TASK`

Retrieves comprehensive details for a ClickUp task by its ID, supporting standard or custom task IDs (requires `team_id` for custom IDs).

### Get task comments

**Slug:** `CLICKUP_GET_TASK_COMMENTS`

Retrieves up to 25 comments for a specified task, supporting pagination using `start` and `start_id` to fetch older comments.

### Get task members

**Slug:** `CLICKUP_GET_TASK_MEMBERS`

Retrieves users with explicit access (directly assigned or shared) to a specific existing task, excluding users with inherited permissions.

### Get tasks

**Slug:** `CLICKUP_GET_TASKS`

Retrieves tasks from a specified ClickUp list; only tasks whose home is the given list_id are returned. Closed and archived tasks are excluded by default. Key task attributes may appear only in the response `custom_fields` array, not top-level fields. Fields like `space`, `folder`, `list`, and `custom_type` may be absent; apply null checks. High-volume paginated calls may return HTTP 429; honor the `Retry-After` header.

### Get task templates

**Slug:** `CLICKUP_GET_TASK_TEMPLATES`

Retrieves task templates for a specified Workspace (Team ID), supporting pagination.

### Get task s time in status

**Slug:** `CLICKUP_GET_TASK_TIME_IN_STATUS`

Retrieves the duration a task has spent in each status, provided the 'Total time in Status' ClickApp is enabled for the Workspace.

### Get team available fields

**Slug:** `CLICKUP_GET_TEAM_AVAILABLE_FIELDS`

Retrieves all custom fields available in a ClickUp Workspace (Team), identified by team_id. Returns Workspace-level custom fields only.

### Get teams

**Slug:** `CLICKUP_GET_TEAMS`

Retrieves user groups (Teams) from a ClickUp Workspace, typically requiring `team_id` (Workspace ID), with an option to filter by `group_ids`.

### Get threaded comments

**Slug:** `CLICKUP_GET_THREADED_COMMENTS`

Retrieves threaded replies to a parent comment. Use when you need to fetch conversation threads under a specific comment.

### Get time entries within a date range

**Slug:** `CLICKUP_GET_TIME_ENTRIES_IN_DATE_RANGE`

Retrieves 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 durations in the response.

### Get singular time entry

**Slug:** `CLICKUP_GET_TIME_ENTRY`

Fetches a specific time entry by its ID for a given team; a negative duration in the response indicates an active timer.

### Get time entry history

**Slug:** `CLICKUP_GET_TIME_ENTRY_HISTORY`

Retrieves the modification history for an existing time entry within a specific ClickUp Team (Workspace).

### Get tracked time

**Slug:** `CLICKUP_GET_TRACKED_TIME`

Retrieves tracked time for a task using a legacy endpoint; prefer newer Time Tracking API endpoints for managing time entries.

### Get user

**Slug:** `CLICKUP_GET_USER`

Retrieves detailed information for a specific user within a ClickUp Workspace (Team), available only for Workspaces on the ClickUp Enterprise Plan.

### Get view

**Slug:** `CLICKUP_GET_VIEW`

Fetches details for a specific ClickUp view, identified by its `view_id`, which must exist.

### Get view tasks

**Slug:** `CLICKUP_GET_VIEW_TASKS`

Retrieves all tasks visible in a specified ClickUp view, respecting its applied filters, sorting, and grouping.

### Get webhooks

**Slug:** `CLICKUP_GET_WEBHOOKS`

Fetches webhooks for a Team (Workspace), returning only those created by the authenticated user via API, for a `team_id` they can access.

### Get workspace everything level views

**Slug:** `CLICKUP_GET_WORKSPACE_EVERYTHING_LEVEL_VIEWS`

Retrieves all task and page views at the 'Everything Level' (a comprehensive overview of all tasks across all Spaces) for a specified ClickUp Workspace.

### Get workspace plan

**Slug:** `CLICKUP_GET_WORKSPACE_PLAN`

Retrieves the details of the current subscription plan for a specified ClickUp Workspace.

### Get workspace seats

**Slug:** `CLICKUP_GET_WORKSPACE_SEATS`

Retrieves seat utilization (used, total, available for members/guests) for a ClickUp Workspace (Team) ID, which must be for an existing Workspace.

### Invite guest to workspace

**Slug:** `CLICKUP_INVITE_GUEST_TO_WORKSPACE`

Invites 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 separate actions.

### Invite user to workspace

**Slug:** `CLICKUP_INVITE_USER_TO_WORKSPACE`

Invites a user via email to a ClickUp Workspace (Team), optionally granting admin rights or a custom role; requires an Enterprise Plan for the Workspace.

### Move task to new home list

**Slug:** `CLICKUP_MOVE_TASK_TO_HOME_LIST`

Tool to move a task to a new home List using ClickUp Public API v3. Use when you need to change a task's home list (not just add to additional lists).

### Remove custom field value

**Slug:** `CLICKUP_REMOVE_CUSTOM_FIELD_VALUE`

Removes an existing value from a Custom Field on a specific task; this does not delete the Custom Field definition or its predefined options.

### Remove guest from folder

**Slug:** `CLICKUP_REMOVE_GUEST_FROM_FOLDER`

Revokes a guest's access to a specific ClickUp Folder, optionally unsharing items explicitly shared with them within it; requires an Enterprise Plan.

### Remove guest from list

**Slug:** `CLICKUP_REMOVE_GUEST_FROM_LIST`

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

### Remove guest from task

**Slug:** `CLICKUP_REMOVE_GUEST_FROM_TASK`

Revokes a guest's access to a specific task; only available for Workspaces on the ClickUp Enterprise Plan.

### Remove guest from workspace

**Slug:** `CLICKUP_REMOVE_GUEST_FROM_WORKSPACE`

Permanently removes a guest from a specified Workspace, revoking all their access; this destructive operation requires the Workspace to be on the ClickUp Enterprise Plan.

### Remove tag from task

**Slug:** `CLICKUP_REMOVE_TAG_FROM_TASK`

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

### Remove tags from time entries

**Slug:** `CLICKUP_REMOVE_TAGS_FROM_TIME_ENTRIES`

Removes tags from specified time entries in a team, without deleting the tags from the workspace.

### Remove task from list

**Slug:** `CLICKUP_REMOVE_TASK_FROM_LIST`

Removes a task from an extra list (not its home list); the 'Tasks in Multiple Lists' ClickApp must be enabled.

### Remove user from workspace

**Slug:** `CLICKUP_REMOVE_USER_FROM_WORKSPACE`

Deactivates a user from a specified ClickUp Workspace, revoking their access (user can be reactivated later); requires the Workspace to be on an Enterprise Plan.

### Search Docs

**Slug:** `CLICKUP_SEARCH_DOCS`

Tool to search and list Docs metadata in a ClickUp workspace. Use after confirming the workspace ID to quickly locate relevant meeting notes before fetching pages.

### Set custom field value

**Slug:** `CLICKUP_SET_CUSTOM_FIELD_VALUE`

Sets 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 in the JSON request body.

### Start a time entry

**Slug:** `CLICKUP_START_TIME_ENTRY`

Starts 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 Business Plan or higher).

### Stop a time entry

**Slug:** `CLICKUP_STOP_TIME_ENTRY`

Stops the authenticated user's currently active time entry in the specified Team (Workspace), which requires an existing time entry to be running.

### Track time

**Slug:** `CLICKUP_TRACK_TIME`

Records a time entry for a task using ClickUp's legacy time tracking system; newer endpoints are generally recommended.

### Update chat channel

**Slug:** `CLICKUP_UPDATE_CHAT_CHANNEL`

Tool to update a ClickUp chat channel's properties including name, topic, description, visibility, and location. Use when you need to modify an existing chat channel's settings. The endpoint requires both workspace_id and channel_id.

### Update chat message

**Slug:** `CLICKUP_UPDATE_CHAT_MESSAGE`

Tool to update a ClickUp chat message's content, assignee, or resolved status via the v3 API. Use when you need to edit an existing chat message.

### Edit checklist

**Slug:** `CLICKUP_UPDATE_CHECKLIST`

Updates an existing checklist's name or position, identified by its `checklist_id`.

### Edit checklist item

**Slug:** `CLICKUP_UPDATE_CHECKLIST_ITEM`

Updates an existing checklist item, allowing modification of its name, assignee, resolution status, or parent item for nesting.

### Update comment

**Slug:** `CLICKUP_UPDATE_COMMENT`

Updates an existing task comment's text, assignee (who must be a valid workspace member), or resolution status, requiring a valid existing comment_id.

### Update folder

**Slug:** `CLICKUP_UPDATE_FOLDER`

Updates the name of an existing folder in ClickUp.

### Update goal

**Slug:** `CLICKUP_UPDATE_GOAL`

Updates attributes of an existing ClickUp goal, identified by its `goal_id`.

### Edit guest on workspace

**Slug:** `CLICKUP_UPDATE_GUEST_ON_WORKSPACE`

Modifies the details and permissions of an existing guest user within a specific Workspace.

### Edit key result

**Slug:** `CLICKUP_UPDATE_KEY_RESULT`

Updates an existing key result's progress or note in ClickUp, where the key result measures progress towards a goal.

### Update list

**Slug:** `CLICKUP_UPDATE_LIST`

Updates attributes of an existing ClickUp list, such as its name, content, due date, priority, assignee, or color status, identified by its `list_id`.

### Update space

**Slug:** `CLICKUP_UPDATE_SPACE`

Updates an existing ClickUp Space, allowing modification of its name, color, privacy, and feature settings (ClickApps).

### Edit space tag

**Slug:** `CLICKUP_UPDATE_SPACE_TAG`

Updates 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 mandatory for the update.

### Update task

**Slug:** `CLICKUP_UPDATE_TASK`

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

### Update team

**Slug:** `CLICKUP_UPDATE_TEAM`

Updates an existing ClickUp User Group (Team) using its `group_id`; note that adding a view-only guest as a paid member may incur charges.

### Update a time entry

**Slug:** `CLICKUP_UPDATE_TIME_ENTRY`

Updates an existing ClickUp time entry. Requires team_id (workspace ID) and timer_id (time entry ID). Optional fields: description, tags, tag_action, start/end times, duration, tid (task ID), billable status. Note: start and end times should be provided together. This is an Advanced Time Tracking feature that may require a Business Plan or higher.

### Change tag names from time entries

**Slug:** `CLICKUP_UPDATE_TIME_ENTRY_TAG`

Updates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team_id`.

### Edit time tracked

**Slug:** `CLICKUP_UPDATE_TIME_TRACKED`

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

### Edit user on workspace

**Slug:** `CLICKUP_UPDATE_USER_ON_WORKSPACE`

Updates a user's username, admin status, or custom role in a Workspace; requires the Workspace to be on an Enterprise Plan.

### Update view

**Slug:** `CLICKUP_UPDATE_VIEW`

Updates 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. for sorting, columns) are valid within the ClickUp workspace.

### Update webhook

**Slug:** `CLICKUP_UPDATE_WEBHOOK`

Updates the endpoint URL, monitored events, and status of an existing webhook, identified by its `webhook_id`.

### Update workspace ACL

**Slug:** `CLICKUP_UPDATE_WORKSPACE_ACL`

Updates privacy and access control list (ACL) permissions for a workspace object or location. Use this to make objects private/public or manage user/team permissions for spaces, folders, lists, tasks, and other ClickUp objects.
