ClickUp

Productivityby ClickUp

Launched Jul 8, 2026 on ChatGPT

The ClickUp connector enables secure, real-time interaction between AI agents like Claude and your ClickUp workspace. Unlock powerful AI-driven automation by connecting your favorite AI tools directly to ClickUp tasks, docs, Chat, and more.

61ChatGPT Tools

35Claude Tools

ClickUpDeveloper

ProductivityCategory

Use Cases

productivitycommunication

Available Tools

Add Tag to Task

clickup_add_tag_to_task

Full Description

Add existing tag to task. Tag must exist in space. Note: Will fail if tag doesn't exist.

Parameters (2 required, 1 optional)

Required

tag_namestring

Name of the tag to add to the task. The tag must already exist in the space.

task_idstring

ID of task. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Add Task Dependency

clickup_add_task_dependency

Full Description

Set a directional dependency where one task blocks the other. Use 'waiting_on' when task_id cannot start until depends_on is done, or 'blocking' when task_id is blocking depends_on. For non-blocking associations, use add_task_link instead.

Parameters (3 required, 1 optional)

Required

depends_onstring

ID of the task that task_id depends on or is blocking. Works with regular and custom IDs.

task_idstring

ID of the task to set the dependency on. Works with regular and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.

typestring

Type of dependency to add: 'waiting_on' or 'blocking'.

Options:waiting_onblocking

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Add Task Link

clickup_add_task_link

Full Description

Link two tasks together. Creates a bidirectional association with no ordering or blocking. For blocking/dependency relationships, use add_task_dependency instead.

Parameters (2 required, 1 optional)

Required

links_tostring

ID of the task to link to. Works with regular and custom IDs.

task_idstring

ID of the task to link from. Works with regular and custom IDs (like 'DEV-1234').

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Add Task to List

clickup_add_task_to_list

Full Description

Add a task to an additional list (keeps current home list). Requires the Tasks in Multiple Lists ClickApp to be enabled.

Parameters (2 required, 1 optional)

Required

list_idstring

ID of the additional list to add the task to. The task remains in its original list. Use clickup_get_list to find the list ID from a list name if needed.

task_idstring

ID of the task to add. Works with regular and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Add Time Entry

clickup_add_time_entry

Full Description

Add a manual time entry to a task. You can provide either (start + duration) OR (start + end). The tool will calculate missing values. Requires task_id, start time, and either duration or end time. Supports description, billable flag, and tags.

Parameters (2 required, 6 optional)

Required

startstring

Start time in YYYY-MM-DD HH:MM format (e.g., '2025-01-15 09:30'). Time is required for time tracking entries.

task_idstring

Task ID (supports custom IDs like 'DEV-1234')

Optional

billableboolean

Whether this time is billable. Default is workspace setting.

descriptionstring

Description for the time entry. Keep short and simple, or omit for best compatibility.

durationstring

Duration of the time entry. Format as 'Xh Ym' (e.g., '1h 30m') or just minutes (e.g., '90m'). Either duration or end_time is required.

end_timestring

End time in YYYY-MM-DD HH:MM format (e.g., '2025-01-15 11:00'). Time is required for time tracking entries.

tagsarray

Array of tag names to assign to the time entry.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Attach Task File

clickup_attach_task_file

Full Description

Attach file to task. Requires task_id. File sources: 1) base64 + filename (small files under ~200KB only), 2) URL (http/https). For files on the local machine, use request_attachment_upload instead.

Parameters (1 required, 5 optional)

Required

task_idstring

Task ID (supports custom IDs like 'DEV-1234')

Optional

auth_headerstring

Authorization header to use when downloading from the web URL.

file_datastring

Base64-encoded content of the file (without the data URL prefix).

file_namestring

Name of the file to be attached (include the extension). Required when using file_data.

file_urlstring

URL to download the file from (must start with http:// or https://).

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Create Comment

clickup_create_comment

Full Description

Create a comment or threaded reply on a task, list, or view. Supports Markdown (headings, bold, code blocks, tables). Use entity_type + entity_id for the target entity. Provide reply_to_id for a threaded reply.

Parameters (1 required, 6 optional)

Required

comment_textstring

Comment content. Supports Markdown formatting. To @mention a user, write a markdown link [@Name](#user_mention#user_id) inline, e.g. 'Hey [@Jane](#user_mention#81344), please review' — user_id MUST be a numeric ClickUp user id from clickup_resolve_assignees (the display name is resolved server-side).

Optional

assigneenumber

User ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.

entity_idstring

ID of the entity to comment on.

entity_typestring

Entity type to comment on. Use with entity_id.

Options:tasklistview

Default: task

notify_allboolean

Whether to notify all assignees. Default is false.

reply_to_idstring

ID of a parent comment to reply to. When provided, the comment is posted as a threaded reply instead of a top-level comment.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Create Document

clickup_create_document

Full Description

Create a document in a ClickUp space, folder, or list. Requires name, parent info, visibility and create_page flag.

Parameters (4 required, 1 optional)

Required

create_pageboolean

Whether to create an initial blank page

namestring

Name and Title of the document

parentobject

Parent container information

visibilitystring

Document visibility setting

Options:PUBLICPRIVATEPERSONALHIDDEN

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Create Document Page

clickup_create_document_page

Full Description

Create a new page in a ClickUp document.

Parameters (3 required, 4 optional)

Required

contentstring

Content of the page

document_idstring

ID of the document to create the page in (e.g. 'ad-909705'). In ClickUp doc URLs, the document_id is always the first ID after /docs/ or /v/dc/.

namestring

Name and title of the page

Optional

content_formatstring

The format of the page content

Options:text/mdtext/plain

Default: text/md

parent_page_idstring

ID of the parent page (if this is a sub-page)

sub_titlestring

Subtitle of the page

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Create Folder

clickup_create_folder

Full Description

Create folder in ClickUp space. Use space_id (preferred) or space_name + folder name. Supports override_statuses for folder-specific statuses. Use clickup_create_list_in_folder to add lists after creation.

Parameters (1 required, 4 optional)

Required

namestring

Name of the folder.

Optional

override_statusesboolean

Whether to override space statuses with folder-specific statuses.

space_idstring

ID of the space to create the folder in (preferred). Provide this instead of space_name if you already have it.

space_namestring

Name of the space to create the folder in. Use this when space_id is not available.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Create List

clickup_create_list

Full Description

Create a list in a ClickUp space. Requires name and space_name or space_id. For lists in folders, use clickup_create_list_in_folder.

Parameters (1 required, 8 optional)

Required

namestring

Name of the list.

Optional

assigneenumber

User ID to assign the list to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.

contentstring

Description or content of the list.

due_datestring

Due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format

prioritystring

Priority value: 'urgent', 'high', 'normal', or 'low'.

Options:urgenthighnormallow

space_idstring

ID of the space to create the list in. Provide this instead of space_name if you already have the ID.

space_namestring

Name of the space to create the list in. Alternative to space_id; one of them must be provided.

statusstring

Status of the list.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Create List in Folder

clickup_create_list_in_folder

Full Description

Create a list in a ClickUp folder. Requires folder_id and list name. Supports content and status. If you need to get a folder ID from a folder name, use clickup_get_folder first.

Parameters (2 required, 3 optional)

Required

folder_idstring

ID of the folder to create the list in.

namestring

Name of the list.

Optional

contentstring

Description or content of the list.

statusstring

Status of the list (uses folder default if not specified).

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Create Reminder

clickup_create_reminder

Full Description

Create a personal reminder in your ClickUp workspace. Requires title and due_date (YYYY-MM-DD or YYYY-MM-DD HH:MM format, uses your timezone).

Parameters (2 required, 2 optional)

Required

due_datestring

Due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format (e.g., '2025-12-31' or '2025-12-31 14:30'). Uses your user timezone.

titlestring

Title for the reminder. Ask the user what they want to be reminded about.

Optional

descriptionstring

Optional description with additional details for the reminder.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Create Task

clickup_create_task

Full Description

Create a task in a ClickUp list. Requires name and list_id — always ask the user which list. Supports assignees (user IDs, emails, usernames, or "me") and task_type by name.

Parameters (2 required, 14 optional)

Required

list_idstring

List ID. Use clickup_get_list to resolve names.

namestring

Task name. Ask the user what they want to name the task.

Optional

assigneesarray

Array of assignee user IDs. Use clickup_resolve_assignees to convert emails, usernames, or "me" to user IDs if needed.

check_required_custom_fieldsboolean

Flag to check if all required custom fields are set before saving the task.

custom_fieldsarray

Array of custom field values to set on the task. Each object must have an 'id' and 'value' property.

descriptionstring

Plain text description for the task.

due_datestring

Due date in YYYY-MM-DD or YYYY-MM-DD HH:MM format

markdown_descriptionstring

Task description in markdown format.

parentstring

Parent task ID to create as subtask.

prioritystring

Task priority: 'urgent', 'high', 'normal', or 'low'. If not provided, task will have no priority assigned.

Options:urgenthighnormallow

start_datestring

Start date in YYYY-MM-DD or YYYY-MM-DD HH:MM format

statusstring

Override default status. Omit to use list defaults.

tagsarray

Tag names (must already exist in the space).

task_typestring

Name of the task type (e.g., 'Bug', 'Feature', 'Milestone'). The type must exist in the workspace. If not specified, the default task type will be used.

time_estimatestring

Time estimate in minutes (e.g., '150' for 2h 30m).

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Create Task Comment (Deprecated)

clickup_create_task_comment

Full Description

[DEPRECATED → clickup_create_comment] Legacy name for creating a task comment, kept for clients with stale tool listings. Prefer the replacement tool; it takes entity_id instead of task_id.

Parameters (2 required, 3 optional)

Required

comment_textstring

Comment content. Supports Markdown formatting.

task_idstring

Task ID (supports custom IDs like 'DEV-1234')

Optional

assigneenumber

User ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.

notify_allboolean

Whether to notify all assignees. Default is false.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Delete Comment

clickup_delete_comment

Full Description

Delete a comment by comment_id. This cannot be undone. Use clickup_get_task_comments or clickup_get_threaded_comments to find the comment ID.

Parameters (1 required, 1 optional)

Required

comment_idstring

ID of the comment to delete. Use clickup_get_task_comments or clickup_get_threaded_comments to find the comment ID.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Delete Task

clickup_delete_task

Full Description

Delete a task by task_id (supports custom IDs like 'DEV-1234'). Always confirm the task_id with the user before deleting.

Parameters (1 required, 1 optional)

Required

task_idstring

Task ID to delete (supports custom IDs like 'DEV-1234')

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Download Document Page Attachment

clickup_download_document_page_attachment

Full Description

Download a ClickUp doc page attachment (get attachment IDs from clickup_list_document_page_attachments). Returns a short-lived download URL plus attachment metadata. IMPORTANT: the URL is short-lived and, on workspaces with private attachments enabled, single-use — it expires within ~5 minutes. Fetch it immediately and exactly once; do not preview, HEAD-request, retry, or store it. If a download fails or the URL expired, call this tool again for a fresh URL.

Parameters (2 required, 1 optional)

Required

attachment_idstring

Attachment ID — the `id` field returned by clickup_list_document_page_attachments for the page.

page_idstring

ID of the doc page (e.g. 'ad-2675877'). In ClickUp doc URLs, the page_id is the second ID after /docs/ or /v/dc/. Use list_document_pages to discover page IDs.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Download Task Attachment

clickup_download_task_attachment

Full Description

Download a ClickUp task attachment (get attachment IDs from clickup_get_task with include: ["attachments"]). Returns a short-lived download URL plus attachment metadata. IMPORTANT: the URL is short-lived and, on workspaces with private attachments enabled, single-use — it expires within ~5 minutes. Fetch it immediately and exactly once; do not preview, HEAD-request, retry, or store it. If a download fails or the URL expired, call this tool again for a fresh URL.

Parameters (2 required, 1 optional)

Required

attachment_idstring

Attachment ID. List a task's attachments with clickup_get_task using include: ["attachments"].

task_idstring

Task ID (supports custom IDs like 'DEV-1234')

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Execute Unified API Operator

clickup_execute_operator

Full Description

Run one enabled Unified API operator (a <model>.<operator> pair) as the authenticated user, in the session workspace. The operator catalog is how this server exposes ClickUp operations beyond the dedicated clickup_* tools, and it grows over time: reach for it when no dedicated tool fits the request or when a request spans many objects (for example several tasks to change, create or read). Call clickup_get_operators first; it lists the enabled operators with each one's parameters and request-body schema, and only enabled operators are callable. Prefer a dedicated clickup_* tool when one covers the whole request in a single call. workspace_id is taken from the session and cannot be overridden. Operators that return full objects (creates and updates included) can produce very large results: pass query with the request to project only the fields you need. Errors carry the upstream status, operationId and response body. Do not retry a call that timed out: the operation may have completed.

Parameters (2 required, 5 optional)

Required

modelstring

Lowercase model name from clickup_get_operators.

operatorstring

Operator from the canonical taxonomy, e.g. `get_many`, `update_many`. Only enabled pairs are accepted.

Options:getlistcreateupdatedeleteget_manylist_childrenduplicatemergearchiveunarchiverestoresearchmovecreate_manyupdate_manydelete_many

Optional

bodyobject

Request body shaped per the schema shown by clickup_get_operators.

operation_idstring

Underlying API operationId; only needed when clickup_get_operators lists several for the pair.

parametersobject

Path and query parameters keyed by the names shown by clickup_get_operators (e.g. `list_id`). workspace_id is filled in automatically.

querystring

Optional JMESPath expression applied to the response to return only what you need, e.g. `items[*].{id: id, name: name}`.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Filter Tasks

clickup_filter_tasks

Full Description

Retrieve tasks with combined filters (tags, lists, folders, spaces, statuses, assignees, due date range, completion date range, custom field values). Multiple values within a filter use OR logic; across filters, AND logic applies (custom_fields entries also AND together). Best for filtering tasks by structured field values. For text/keyword search across all workspace content, use search instead. Custom field filters need field IDs — discover them with clickup_get_custom_fields. Results are paginated at 100 tasks per page: the response includes has_more and next_page, and when has_more is true you MUST call again with page set to next_page (repeating until has_more is false) to retrieve every matching task — a single call is not guaranteed to be complete. Assignees must be numeric user IDs — use clickup_resolve_assignees to convert names/emails/"me". Date filters use YYYY-MM-DD. For a single task by ID, use clickup_get_task.

Parameters (0 required, 17 optional)

Optional

assigneesarray

Filter by assignee user IDs. Multiple IDs use OR logic. Use clickup_resolve_assignees to convert names/emails/"me" first.

custom_fieldsarray

Filter by custom field values. Entries combine with AND (and with all other filters).

date_closed_fromstring

Filter tasks completed on or after. Format: YYYY-MM-DD

date_closed_tostring

Filter tasks completed on or before. Format: YYYY-MM-DD

due_date_fromstring

Filter tasks with due date on or after. Format: YYYY-MM-DD

due_date_tostring

Filter tasks with due date on or before. Format: YYYY-MM-DD

folder_idsarray

Filter by Folder IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified folders).

include_closedboolean

Include closed tasks in results

list_idsarray

Filter by List IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified lists).

order_bystring

Sort results by field. Default direction is descending — newest first for created/updated. Set reverse: true for ascending (oldest first).

Options:idcreatedupdateddue_date

pagenumber

0-indexed page number. Each page returns up to 100 tasks. When a response has has_more=true, request the next page using its next_page value, and keep going until has_more=false to retrieve every matching task.

reverseboolean

Sort ascending (oldest first) instead of the default descending (newest first). Leave unset/false to get the most recently created/updated tasks first.

space_idsarray

Filter by Space IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified spaces).

statusesarray

Filter by task status names. Multiple statuses use OR logic (matches tasks with ANY of the specified statuses).

subtasksboolean

Include subtasks in results (default: true)

Default: True

tagsarray

Filter by tag names. Multiple tags use OR logic (matches tasks with ANY of the specified tags).

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Find Member by Name

clickup_find_member_by_name

Full Description

Get a member in the ClickUp workspace by name or email. Returns the member object if found, or null if not found.

Parameters (1 required, 1 optional)

Required

name_or_emailstring

The name or email of the member to find.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Bulk Tasks Time in Status

clickup_get_bulk_tasks_time_in_status

Full Description

Get the time multiple tasks have spent in each status (bulk operation, up to 100 tasks). Returns a map of task IDs to their status history and current status time data. Requires the "Total time in Status" ClickApp to be enabled in the workspace.

Parameters (1 required, 1 optional)

Required

task_idsarray

Array of task IDs to get time in status for (1-100 tasks). Works with both regular task IDs and custom IDs (like 'DEV-1234').

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Chat Channel Messages

clickup_get_chat_channel_messages

Full Description

Get messages for a chat channel. Messages with has_replies=true have threads fetchable via clickup_get_chat_message_replies. Supports pagination. Channel URLs look like /<ws>/v/cn/<channel_id> or /<ws>/chat/r/<channel_id>.

Parameters (1 required, 4 optional)

Required

channel_idstring

ID of the chat channel to get messages from.

Optional

content_formatstring

Response content format.

Options:text/plaintext/md

Default: text/plain

cursorstring

Cursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.

limitnumber

Maximum number of messages to return (1-100).

Default: 100

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Chat Channels

clickup_get_chat_channels

Full Description

List chat channels in the workspace with pagination support.

Parameters (0 required, 3 optional)

Optional

cursorstring

Cursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.

limitnumber

Maximum number of channels to return (1-100).

Default: 100

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Chat Message Replies

clickup_get_chat_message_replies

Full Description

Get threaded replies for a chat message by message_id. Supports pagination. Chat thread URLs (/<ws>/v/cn/<channel_id>/t/<id> or /<ws>/chat/r/<channel_id>/t/<id>) end in a chat message id — pass it here, not to clickup_get_task. That id is usually the thread root but can be a reply inside the thread; if no replies come back, find the thread root via clickup_get_chat_channel_messages on the channel.

Parameters (1 required, 4 optional)

Required

message_idstring

ID of the chat message to get replies from.

Optional

content_formatstring

Response content format.

Options:text/plaintext/md

Default: text/plain

cursorstring

Cursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.

limitnumber

Maximum number of replies to return (1-100).

Default: 100

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Current Time Entry

clickup_get_current_time_entry

Full Description

Get the currently running time entry, if any. No parameters needed.

Parameters (0 required, 1 optional)

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Custom Fields

clickup_get_custom_fields

Full Description

Get custom field definitions at any hierarchy level (list, folder, space, or workspace). Returns field IDs, types, and options for dropdowns/labels. Use this to discover available custom fields before setting values on tasks. Multiple scopes can be queried in a single call.

Parameters (0 required, 5 optional)

Optional

folder_idstring

Folder ID. Returns custom fields defined on this folder.

include_workspaceboolean

If true, returns workspace-level custom fields.

list_idstring

List ID. Returns custom fields defined on this list.

space_idstring

Space ID. Returns custom fields defined on this space.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Document Pages

clickup_get_document_pages

Full Description

Get the full content of specific pages by page ID. Use list_document_pages first to discover available page IDs.

Parameters (2 required, 2 optional)

Required

document_idstring

ID of the document (e.g. 'ad-909705'). In ClickUp doc URLs the path is either /{workspace_id}/docs/{document_id}/{page_id} or /{workspace_id}/v/dc/{document_id}/{page_id}. The document_id is always the first ID after /docs/ or /v/dc/.

page_idsarray

Array of page IDs to retrieve (e.g. ['ad-2675877']). In ClickUp doc URLs, the page_id is the second ID after /docs/ or /v/dc/. If the URL contains only one ID (e.g. /{workspace_id}/docs/{document_id}), that is the document_id — use list_document_pages to discover page IDs.

Optional

content_formatstring

Response content format.

Options:text/plaintext/md

Default: text/plain

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Folder

clickup_get_folder

Full Description

Get folder details by folder_id or folder_name (+ space info). Use to resolve folder names to IDs.

Parameters (0 required, 5 optional)

Optional

folder_idstring

ID of the folder to retrieve.

folder_namestring

Name of the folder to retrieve. When using this, you must also provide space_id or space_name.

space_idstring

ID of the space containing the folder (required with folder_name).

space_namestring

Name of the space containing the folder (required with folder_name).

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get List

clickup_get_list

Full Description

Get list details by list_id or list_name. Returns id, name, content, space info, and configured statuses. Use to resolve list names to IDs.

Parameters (0 required, 3 optional)

Optional

list_idstring

ID of the list to retrieve.

list_namestring

Name of the list to retrieve. The tool will search for a list with this name.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

List Unified API Operators

clickup_get_operators

Full Description

Lists the Unified API operators enabled on this server (<model>.<operator> pairs) with each one's HTTP route, parameters and request/response body schema, as Markdown. The catalog is how this server exposes ClickUp operations beyond the dedicated clickup_* tools, and it grows over time: call this whenever no dedicated tool fits the request, whenever a request spans many objects, and always before clickup_execute_operator to build a correct call. It is also the only reliable answer to what this server can do: answer any question about its capabilities by calling it, never from tool names or descriptions. Operators that are not enabled are never shown.

Parameters (0 required, 3 optional)

Optional

model_operatorsarray

Restrict the output to these `<model>.<operator>` pairs.

modelsarray

Restrict the output to every enabled operator of these models.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Unified API Entity Schema

clickup_get_schema

Full Description

Returns the entity-relationship schema (Markdown with a Mermaid ER diagram) for the models behind the enabled Unified API operators. Optional background before a clickup_execute_operator call; not needed for the dedicated clickup_* tools.

Parameters (0 required, 5 optional)

Optional

detailedboolean

Include the long-form description of each entity and relationship instead of the one-line summary.

entities_onlyboolean

Return only the entity list — no relationships, no diagram.

namesarray

Restrict the output to these entity names (lowercase). Only enabled models are returned.

tierstring

Minimum importance tier to include: `primary` (overview), `secondary`, or `attribute` (everything, the default).

Options:primarysecondaryattribute

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Task

clickup_get_task

Full Description

Retrieve a ClickUp task by ID (supports custom IDs like 'DEV-1234'). Returns a compact summary by default — core fields are always included, large sections appear as counts only (e.g. custom_fields_count: 3). Use include to fetch full data for specific sections: include: ["custom_fields", "description"]. Set expand_statuses=true to list valid statuses for update_task. URL disambiguation: a bare /t/<id> or /t/<workspace>/<id> ClickUp URL is a task, but in chat thread URLs (/v/cn/<channel_id>/t/<id> or /chat/r/<channel_id>/t/<id>) the trailing id is a chat MESSAGE id — use clickup_get_chat_message_replies for those.

Parameters (1 required, 5 optional)

Required

task_idstring

Task ID (supports custom IDs like 'DEV-1234')

Optional

detail_levelstring

Level of detail to return. Use 'summary' for lightweight responses or 'detailed' for full task data. Defaults to 'detailed' but automatically switches to 'summary' if response would be too large.

Options:summarydetailed

expand_statusesboolean

When true, returns the full set of statuses configured on the task's list (including any inherited from the parent folder or space) under `available_statuses`. Use to discover which status values can be assigned via update_task. Off by default to keep responses lean.

includearray

Sections to return in full. Without this, large sections appear as counts (e.g. custom_fields_count: 3). Available: attachments (metadata only — id, title, extension, mimetype, size, date, source; use clickup_download_task_attachment to get a download URL), checklists (items + completion), custom_fields (field values), dependencies (blocking/waiting-on relationships), description (full text — summary truncates at 10k chars), linked_tasks (linked task IDs), subtasks (triggers subtask fetch from API), watchers (watching users).

subtasksboolean

Whether to include subtasks in the response. Set to true to retrieve full details of all subtasks.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Task Comments

clickup_get_task_comments

Full Description

Get task comments with reply_count per comment. Use clickup_get_threaded_comments for replies when reply_count > 0. Supports pagination via start/start_id.

Parameters (1 required, 3 optional)

Required

task_idstring

Task ID (supports custom IDs like 'DEV-1234')

Optional

startnumber

Timestamp (in milliseconds) to start retrieving comments from. Used for pagination.

start_idstring

Comment ID to start from. Used together with start for pagination.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Clickup Get Task Time Entries

clickup_get_task_time_entries

Full Description

Get all time entries for a task with filtering options. Returns all tracked time with user info, descriptions, tags, start/end times, and durations.

Parameters (1 required, 4 optional)

Required

task_idstring

ID of task. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.

Optional

end_datestring

End date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format

is_billableboolean

Filter by billable status. Set to true to get only billable time entries, false for non-billable entries. Omit to get all entries regardless of billable status.

start_datestring

Start date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format

workspace_idstring

The unique identifier for the ClickUp workspace. When not provided, this will be automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace. You can find your Workspace ID in the URL when in your workspace (format: 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').

Get Task Time in Status

clickup_get_task_time_in_status

Full Description

Get the time a task has spent in each status. Returns the current status with elapsed time and the full status history with time spent in each status. Requires the "Total time in Status" ClickApp to be enabled in the workspace.

Parameters (1 required, 1 optional)

Required

task_idstring

ID of task. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Threaded Comments

clickup_get_threaded_comments

Full Description

Get threaded replies for a comment by comment_id. Use clickup_get_task_comments first to find comments with reply_count > 0.

Parameters (1 required, 1 optional)

Required

comment_idstring

ID of the parent comment to get threaded replies for.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Time Entries

clickup_get_time_entries

Full Description

Get time entries with optional filtering by task, date range, assignee, and billable status. Pass task_id to scope to a single task, or omit for workspace-wide results. IMPORTANT: without assignee, only the authenticated user's entries are returned — pass 'any' to get all users' entries, or specific user IDs (comma-separated) for targeted queries.

Parameters (0 required, 6 optional)

Optional

assigneearray

Filter by assignee user IDs. Pass numeric user IDs (e.g. ['123', '456']) or include 'any' to get ALL users' entries. IMPORTANT: when omitted, the API returns only the authenticated user's entries. Use get_workspace_members to look up user IDs.

end_datestring

End date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format

is_billableboolean

Filter by billable status. Set to true for only billable entries, false for non-billable. Omit to get all entries.

start_datestring

Start date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format

task_idstring

Task ID to scope entries to (supports custom IDs like 'DEV-1234'). Omit to query workspace-wide.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Workspace Hierarchy

clickup_get_workspace_hierarchy

Full Description

Get workspace hierarchy (spaces, folders, lists) with pagination and depth control. Use only when you need the workspace structure — most tools resolve names automatically.

Parameters (0 required, 5 optional)

Optional

cursorstring

Pagination cursor from previous response. Use to fetch next page of spaces

limitnumber

Maximum number of spaces to return per page (default: 10, max: 50)

max_depthstring

Maximum depth of hierarchy to return: 0=spaces only, 1=spaces+folders, 2=spaces+folders+lists (default: 2)

Options:012

space_idsarray

Filter to return only specific spaces by ID.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Get Workspace Members

clickup_get_workspace_members

Full Description

List all members in the workspace. Most tools resolve assignees automatically — use only when you need the full member list.

Parameters (0 required, 1 optional)

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

List Document Page Attachments

clickup_list_document_page_attachments

Full Description

List metadata for files attached to a ClickUp doc page (images and files embedded in the page content).

Parameters (1 required, 3 optional)

Required

page_idstring

ID of the doc page (e.g. 'ad-2675877'). In ClickUp doc URLs, the page_id is the second ID after /docs/ or /v/dc/. Use list_document_pages to discover page IDs.

Optional

cursorstring

Cursor from a previous response to fetch the next page of results.

limitinteger

Maximum number of attachments to return (1-100, default 50).

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

List Document Pages

clickup_list_document_pages

Full Description

List page names and structure of a document (no content). Use get_document_pages to fetch full page content by page ID.

Parameters (1 required, 2 optional)

Required

document_idstring

ID of the document (e.g. 'ad-909705'). In ClickUp doc URLs the path is either /{workspace_id}/docs/{document_id} or /{workspace_id}/v/dc/{document_id}. The document_id is always the first ID after /docs/ or /v/dc/.

Optional

max_page_depthnumber

Maximum depth of pages to retrieve (-1 for unlimited)

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Merge Tasks

clickup_merge_tasks

Full Description

Merge one or more source tasks into a target task. The target task survives and absorbs content from the source tasks, which are consumed. Destination field values take precedence on conflicts. Works with both regular task IDs and custom IDs (like 'DEV-1234').

Parameters (2 required, 1 optional)

Required

source_task_idsarray

Array of task IDs to merge into the target task. These tasks will be consumed/deleted after merging. Works with both regular task IDs and custom IDs (like 'DEV-1234').

task_idstring

ID of the target/destination task that will survive the merge. Source tasks will be merged into this task. Works with both regular task IDs and custom IDs (like 'DEV-1234').

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Move Task

clickup_move_task

Full Description

Move a task to a new home list. Requires task_id and list_id (supports custom IDs). Use clickup_get_list to resolve list names.

Parameters (2 required, 1 optional)

Required

list_idstring

ID of the destination list to move the task into. Use clickup_get_list to find the list ID from a list name if needed.

task_idstring

ID of the task to move. Works with regular and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Remove Tag from Task

clickup_remove_tag_from_task

Full Description

Remove tag from task. Only removes tag-task association, tag remains in space.

Parameters (2 required, 1 optional)

Required

tag_namestring

Name of the tag to remove from the task.

task_idstring

ID of task. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Remove Task Dependency

clickup_remove_task_dependency

Full Description

Remove a dependency between two tasks.

Parameters (3 required, 1 optional)

Required

depends_onstring

ID of the task that was in the dependency relationship. Works with both regular task IDs and custom IDs (like 'DEV-1234').

task_idstring

ID of the task to remove the dependency from. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.

typestring

Type of dependency to remove: 'waiting_on' or 'blocking'.

Options:waiting_onblocking

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Remove Task from List

clickup_remove_task_from_list

Full Description

Remove a task from an additional list (cannot remove from home list). Requires the Tasks in Multiple Lists ClickApp to be enabled.

Parameters (2 required, 1 optional)

Required

list_idstring

ID of the additional list to remove the task from. Use clickup_get_list to find the list ID from a list name if needed.

task_idstring

ID of the task to remove from the additional list. Works with regular and custom IDs (like 'DEV-1234'). Note: a task cannot be removed from its home list.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Remove Task Link

clickup_remove_task_link

Full Description

Remove a link between two tasks.

Parameters (2 required, 1 optional)

Required

links_tostring

ID of the task that was linked to. Works with both regular task IDs and custom IDs (like 'DEV-1234').

task_idstring

ID of the task to remove the link from. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Request Attachment Upload

clickup_request_attachment_upload

Full Description

Get short-lived, structured upload details (upload URL, ticket, HTTP method, and multipart field name) to attach a LOCAL file (any size) to a task; follow the returned instructions to upload it with a native HTTP client. For small base64 payloads or web URLs, use attach_task_file instead.

Parameters (1 required, 2 optional)

Required

task_idstring

Task ID (supports custom IDs like 'DEV-1234')

Optional

file_namestring

Optional file name override (include the extension). Defaults to the local file's own name.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Resolve Assignees

clickup_resolve_assignees

Full Description

Convert names, emails, or "me" to numeric ClickUp user IDs. Use when you need IDs for filters (e.g., search, filter_tasks). Most task tools resolve assignees automatically.

Parameters (1 required, 1 optional)

Required

assigneesarray

Array of assignee names, emails, or "me" to resolve. Use "me" to refer to the currently authenticated user.

Optional

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Search Workspace

clickup_search

Full Description

Search across all workspace content (tasks, docs, dashboards, attachments, whiteboards, chats, forms). Best for keyword/text matching across all content types. For filtering tasks by field values (status, priority, tags, dates), use filter_tasks instead. Supports filtering by assignees, creators, status, location, asset types, and date ranges. Date filters use YYYY-MM-DD or YYYY-MM-DD HH:MM format in your timezone. Results are paginated: the response includes next_cursor whenever more results exist. When next_cursor is present you MUST call search again with that value in the cursor field (repeating until next_cursor is absent) to retrieve every match — a single call is not guaranteed to be complete.

Parameters (0 required, 6 optional)

Optional

countnumber

Maximum number of results to return per page (for pagination)

cursorstring

Pagination cursor from previous response. Use to fetch next page of results

filtersobject

Filters to refine search results by various criteria

keywordsstring

Search query string. Use specific keywords to find items

sortarray

Sort criteria for results. Can specify multiple sort fields in priority order

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Search Reminders

clickup_search_reminders

Full Description

Search and list your reminders. Supports filtering by type, status, completion, and since date. Date filters use YYYY-MM-DD or YYYY-MM-DD HH:MM format (e.g., '2025-01-01') in your timezone. Paginated via cursor.

Parameters (0 required, 8 optional)

Optional

cursorstring

Cursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results

due_date_statusstring

Filter reminders by due date status (TODO, LATER, DELETED)

Options:TODOLATERDELETED

is_completedboolean

Filter to show only completed or incomplete reminders

is_overdueboolean

Filter to show only overdue reminders

limitnumber

Maximum number of reminders to return per page (default: 25, max: 100)

reminder_typestring

Filter by type of reminder (ASSIGNED_COMMENT, UNANSWERED_MENTION, APPROVAL, SAVED, REMINDER)

Options:ASSIGNED_COMMENTUNANSWERED_MENTIONAPPROVALSAVEDREMINDER

sincestring

Filter reminders updated since this date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format (e.g., '2025-01-01' or '2025-01-01 09:00')

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Send Chat Message

clickup_send_chat_message

Full Description

Send a message or threaded reply to a chat channel. Provide parent_message_id for threaded replies. Supports markdown and post types.

Parameters (2 required, 10 optional)

Required

channel_idstring

ID of the chat channel to send the message to. Ignored when parent_message_id is set — a reply's channel is derived from its parent message.

contentstring

Message content to send (supports markdown).

Optional

assigneestring

User ID to assign the message to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.

content_formatstring

Format of the message content.

Options:text/mdtext/plain

Default: text/md

followersarray

Array of user IDs to add as followers of the message. Use clickup_resolve_assignees to convert emails, usernames, or "me" to user IDs if needed.

group_assigneestring

Group ID to assign the message to.

parent_message_idstring

ID of the parent message to reply to. When provided, the message is sent as a threaded reply instead of a top-level channel message. Use clickup_get_chat_channel_messages to find the message ID.

post_subtype_idstring

Subtype ID for the post (required if type is 'post').

post_titlestring

Title for the post (required if type is 'post').

post_typestring

Kind of post (required if type is 'post'). Resolved to the workspace's post subtype.

Options:UpdateAnnouncementIdeaDiscussion

typestring

Type of message to send.

Options:messagepost

Default: message

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Start Time Tracking

clickup_start_time_tracking

Full Description

Start time tracking on a task. Supports description, billable status, and tags. Only one timer can be running at a time. For best results, omit extra parameters unless specifically needed.

Parameters (1 required, 4 optional)

Required

task_idstring

Task ID (supports custom IDs like 'DEV-1234')

Optional

billableboolean

Whether this time is billable. Default is workspace setting.

descriptionstring

Description for the time entry. Keep short and simple, or omit for best compatibility.

tagsarray

Array of tag names to assign to the time entry.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Stop Time Tracking

clickup_stop_time_tracking

Full Description

Stop the currently running time tracker. Supports description and tags. Returns the completed time entry details.

Parameters (0 required, 3 optional)

Optional

descriptionstring

Description to update or add to the time entry.

tagsarray

Array of tag names to assign to the time entry.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Update Comment

clickup_update_comment

Full Description

Edit an existing comment in place by comment_id. Replaces the comment text (supports Markdown), and can mark it resolved or reassign it. Use clickup_get_task_comments or clickup_get_threaded_comments to find the comment ID.

Parameters (1 required, 4 optional)

Required

comment_idstring

ID of the comment to update. Use clickup_get_task_comments or clickup_get_threaded_comments to find the comment ID.

Optional

assigneenumber

User ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.

comment_textstring

New comment content that replaces the existing text. Supports Markdown formatting. To @mention a user, write [@Name](#user_mention#user_id) inline — user_id MUST be a numeric ClickUp user id from clickup_resolve_assignees.

resolvedboolean

Mark the comment as resolved (true) or unresolved (false).

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Update Document Page

clickup_update_document_page

Full Description

Update a page in a ClickUp document. Use content_edit_mode to control how content is applied: append/prepend merge with the existing page server-side and preserve it exactly — no need to read the page first. The default is 'replace', which overwrites the whole page. If appended content should start on its own line, include a leading newline; if prepended content should end on its own line, include a trailing newline.

Parameters (2 required, 6 optional)

Required

document_idstring

ID of the document containing the page (e.g. 'ad-909705'). In ClickUp doc URLs, the document_id is always the first ID after /docs/ or /v/dc/.

page_idstring

ID of the page to update (e.g. 'ad-2675877'). In ClickUp doc URLs, this is the second ID after /docs/ or /v/dc/.

Optional

contentstring

New content for the page (must be non-empty; clearing a page is not supported). By default this REPLACES the entire existing page content — set content_edit_mode to 'append' or 'prepend' to add to the page instead of overwriting it.

content_edit_modestring

How to apply `content`: 'append' adds it at the end of the existing page, 'prepend' inserts it before the existing content, 'replace' (default) OVERWRITES the entire page — existing content is lost. Ignored when `content` is not provided.

Options:replaceappendprepend

Default: replace

content_formatstring

The format of the page content

Options:text/mdtext/plain

Default: text/md

namestring

New name for the page

sub_titlestring

New subtitle for the page

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Update Folder

clickup_update_folder

Full Description

Update a ClickUp folder. Requires folder_id + at least one update field (name/override_statuses). Only specified fields updated. Changes apply to all lists in folder. If you need to get a folder ID from a folder name, use clickup_get_folder first.

Parameters (1 required, 3 optional)

Required

folder_idstring

ID of the folder to update.

Optional

namestring

New name for the folder.

override_statusesboolean

Whether to override space statuses with folder-specific statuses.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Update List

clickup_update_list

Full Description

Update a ClickUp list. Requires list_id + at least one update field (name/content/status). Only specified fields updated. If you need to get a list ID from a list name, use clickup_get_list first.

Parameters (1 required, 4 optional)

Required

list_idstring

ID of the list to update.

Optional

contentstring

New description or content for the list.

namestring

New name for the list.

statusstring

New status for the list.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Update Reminder

clickup_update_reminder

Full Description

Update a reminder by reminder_id. Supports title, description, due_date (YYYY-MM-DD or YYYY-MM-DD HH:MM, e.g. '2025-12-31'), and is_completed.

Parameters (1 required, 5 optional)

Required

reminder_idstring

The unique identifier (KSUID) of the reminder to update.

Optional

descriptionstring

New description for the reminder.

due_datestring

New due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format (e.g., '2025-12-31' or '2025-12-31 14:30'). Uses your user timezone.

is_completedboolean

Set to true to mark the reminder as completed, false to mark as incomplete.

titlestring

New title for the reminder.

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Update Task

clickup_update_task

Full Description

Update task properties. Requires task_id and at least one field to change. Supports assignees (user IDs, emails, usernames, or "me"), custom fields as [{id, value}], and task_type by name (or 'none' to reset).

Parameters (1 required, 12 optional)

Required

task_idstring

Task ID (supports custom IDs like 'DEV-1234')

Optional

assigneesarray

Array of assignee user IDs. Use clickup_resolve_assignees to convert emails, usernames, or "me" to user IDs if needed.

custom_fieldsarray

Array of custom field values to set on the task. Each object must have an 'id' and 'value' property.

descriptionstring

New plain text description. Will be ignored if markdown_description is provided.

due_datestring

YYYY-MM-DD or YYYY-MM-DD HH:MM format. Pass 'none' to clear. Omit to leave unchanged.

markdown_descriptionstring

Task description in markdown format.

namestring

New name for the task.

prioritystring

Set priority, or 'none' to clear. Omit to leave unchanged.

Options:urgenthighnormallownone

start_datestring

YYYY-MM-DD or YYYY-MM-DD HH:MM format. Pass 'none' to clear. Omit to leave unchanged.

statusstring

New status (must be valid for the task's list).

task_typestring

To change the task type, pass the type name as a string (e.g., 'Bug', 'Feature', 'Milestone'). The type must exist in the workspace. To revert to the default 'Task' type, pass 'none'. Omit entirely to leave unchanged.

time_estimatestring

Time estimate in minutes (e.g., '150' for 2h 30m).

workspace_idstring

Workspace ID (digits only). Only needed when you have multiple workspaces.

Links

Website Privacy Policy Terms of Service