Your AI team, working in ClickUp

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

Start your company

What your team can do in ClickUp

165 tools to work with, connected with your account.

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

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

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

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

Add tag to task

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

Add tags from time entries

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

Add task link

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

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.

Change tag names from time entries

Updates an existing time entry tag in a workspace, identified by its current name. Requires the new name, background color, and foreground color.

Create a 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 a time entry

Creates a new time entry for a specified team.

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

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

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

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

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

Creates a named checklist item within a specified existing checklist, optionally assigning it to a user.

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

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

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

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

Create folder view

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

Create folderless list

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

Create goal

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

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

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

Adds a text comment to a ClickUp List, optionally assigning it to a user and setting the notify-all preference.

Create list from template in folder

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

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

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

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

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

Create space tag

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

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 task attachment

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

Create task attachment

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

Create task comment

Adds a comment to a ClickUp task, assigning it to the supplied user and specifying whether to notify all watchers. Team ID is required when using custom task IDs.

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

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

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

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

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 a time entry

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

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

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

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

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

Delete checklist item

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

Delete comment

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

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

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

Delete goal

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

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

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

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

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

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

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

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

Delete time tracked

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

Delete view

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

Delete webhook

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

Edit checklist

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

Edit checklist item

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

Edit guest on workspace

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

Edit key result

Updates an existing ClickUp key result's progress and note. Both the current progress value and note are required.

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

Edit 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

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

Get access token

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

Get accessible custom fieldsReads only

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

Get all tags from time entriesReads only

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

Get authorized teams workspacesReads only

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

Get authorized teams workspacesReads only

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

Get authorized userReads only

Retrieves the details of the currently authenticated ClickUp user.

Get bulk tasks time in statusReads only

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 channelReads only

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

Get chat channel followersReads only

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 membersReads only

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 channelsReads only

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 reactionsReads only

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 repliesReads only

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 message tagged usersReads only

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 messagesReads only

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 view commentsReads only

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 rolesReads only

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

Get custom task typesReads only

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

Get DocReads only

Fetch metadata for one ClickUp Doc without fetching its pages or content.

Get Doc ContentReads only

Fetches a ClickUp Doc's metadata and page content, with options to select pages or return a page listing without content. Page content is returned in a markdown field when available.

Get Doc Page ContentReads only

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 ListingReads only

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 PagesReads only

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 tasksReads only

Retrieves a paginated, filtered list of workspace tasks, subject to user access; keyword/text search is not supported. Results contain trimmed task fields and descriptions limited to 200 characters, without comments.

Get folderReads only

Retrieves detailed information about a specific folder in ClickUp.

Get Folder Available FieldsReads only

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 folder viewsReads only

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

Get folderless listsReads only

Retrieves folderless Lists in a specified ClickUp Space, with an optional archived-status filter.

Get foldersReads only

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

Get goalReads only

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

Get goalsReads only

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

Get guestReads only

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 listReads only

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

Get list commentsReads only

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 membersReads only

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

Get list viewsReads only

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

Get listsReads only

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

Get post subtype IDsReads only

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 running time entryReads only

Retrieves the currently active time entry for a user in a Workspace; a negative duration indicates that the timer is running.

Get singular time entryReads only

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

Get spaceReads only

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

Get space available fieldsReads only

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

Get space tagsReads only

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

Get space viewsReads only

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

Get spacesReads only

Retrieves Spaces for a ClickUp Team (Workspace), with an optional archived-status filter.

Get taskReads only

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

Get task commentsReads only

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

Get task membersReads only

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

Get task s time in statusReads only

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

Get task templatesReads only

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

Get tasksReads only

Retrieves tasks from a specified ClickUp list; only tasks whose home is the given list_id are returned, and closed and archived tasks are excluded by default. Key task attributes may appear in custom_fields, and folder may be absent; high-volume calls may return HTTP 429.

Get team available fieldsReads only

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

Get teamsReads only

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

Get threaded commentsReads only

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 rangeReads only

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 time entry historyReads only

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

Get tracked timeReads only

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

Get userReads only

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

Get viewReads only

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

Get view tasksReads only

Retrieves a page of tasks from a specified ClickUp view, respecting its applied filters, sorting, and grouping. The response indicates whether it is the last page.

Get webhooksReads only

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 viewsReads only

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 planReads only

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

Get workspace seatsReads only

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

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

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

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

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

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

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

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

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

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

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

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

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 DocsReads only

Lists Docs metadata in a ClickUp workspace, with cursor pagination. Results can be inspected to locate relevant documents before fetching their pages.

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.

Shared hierarchyReads only

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

Start a 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

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

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

Update a 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.

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

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.

Update comment

Updates an existing task comment by ID, supplying its text, assignee, and resolution status.

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.

Update folder

Updates the name of an existing folder in ClickUp.

Update goal

Updates an existing ClickUp goal by ID. Requires its name, description, due date, color, and lists of owners to add and remove.

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

Updates a ClickUp Space's name, color, privacy, multiple-assignee setting, and optionally its feature settings (ClickApps). The name, color, privacy, and multiple-assignee setting are required.

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

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

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

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.

More in Productivity

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or