Skip to content
Scalekit Docs
Talk to an EngineerDashboard

ClickUp MCP

Vendor MCP58 toolsOAuth 2.1/DCRProject ManagementProductivityCollaboration

Connect to ClickUp MCP to manage tasks, projects, spaces, and workspaces directly from your AI workflows.

ClickUp MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'clickupmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize ClickUp MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'clickupmcp_clickup_get_list',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Update clickup — Update task properties
  • Tracking clickup stop time, clickup start time — Stop the currently running time tracker
  • Send clickup — Send a message or threaded reply to a chat channel
  • Search clickup — Search and list your reminders
  • Assignees clickup resolve — Convert names, emails, or “me” to numeric ClickUp user IDs
  • Upload clickup request attachment — 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

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

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

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

NameTypeRequiredDescription
tag_namestringrequiredName of the tag to add to the task. The tag must already exist in the space.
task_idstringrequiredID 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.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_add_task_dependency#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.4 params

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.

NameTypeRequiredDescription
depends_onstringrequiredID of the task that task_id depends on or is blocking. Works with regular and custom IDs.
task_idstringrequiredID 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.
typestringrequiredType of dependency to add: 'waiting_on' or 'blocking'.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_add_task_to_list#Add a task to an additional list (keeps current home list). Requires the Tasks in Multiple Lists ClickApp to be enabled.3 params

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

NameTypeRequiredDescription
list_idstringrequiredID 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_idstringrequiredID 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.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_add_time_entry#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.8 params

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.

NameTypeRequiredDescription
startstringrequiredStart time in YYYY-MM-DD HH:MM format (e.g., '2025-01-15 09:30'). Time is required for time tracking entries.
task_idstringrequiredTask ID (supports custom IDs like 'DEV-1234')
billablebooleanoptionalWhether this time is billable. Default is workspace setting.
descriptionstringoptionalDescription for the time entry. Keep short and simple, or omit for best compatibility.
durationstringoptionalDuration 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_timestringoptionalEnd time in YYYY-MM-DD HH:MM format (e.g., '2025-01-15 11:00'). Time is required for time tracking entries.
tagsarrayoptionalArray of tag names to assign to the time entry.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_attach_task_file#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.6 params

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.

NameTypeRequiredDescription
task_idstringrequiredTask ID (supports custom IDs like 'DEV-1234')
auth_headerstringoptionalAuthorization header to use when downloading from the web URL.
file_datastringoptionalBase64-encoded content of the file (without the data URL prefix).
file_namestringoptionalName of the file to be attached (include the extension). Required when using file_data.
file_urlstringoptionalURL to download the file from (must start with http:// or https://).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_create_comment#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.7 params

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.

NameTypeRequiredDescription
comment_textstringrequiredComment content. Supports Markdown formatting. To @mention a user, write @[Name](user_id) inline, e.g. 'Hey @[Jane](81344), please review' — user_id MUST be a numeric ClickUp user id from clickup_resolve_assignees. Comments with mentions post as plain text (no Markdown).
assigneenumberoptionalUser ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.
entity_idstringoptionalID of the entity to comment on.
entity_typestringoptionalEntity type to comment on. Use with entity_id.
notify_allbooleanoptionalWhether to notify all assignees. Default is false.
reply_to_idstringoptionalID of a parent comment to reply to. When provided, the comment is posted as a threaded reply instead of a top-level comment.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_create_document#Create a document in a ClickUp space, folder, or list. Requires name, parent info, visibility and create_page flag.5 params

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

NameTypeRequiredDescription
create_pagebooleanrequiredWhether to create an initial blank page
namestringrequiredName and Title of the document
parentobjectrequiredParent container information
visibilitystringrequiredDocument visibility setting
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_create_document_page#Create a new page in a ClickUp document.7 params

Create a new page in a ClickUp document.

NameTypeRequiredDescription
contentstringrequiredContent of the page
document_idstringrequiredID 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/.
namestringrequiredName and title of the page
content_formatstringoptionalThe format of the page content
parent_page_idstringoptionalID of the parent page (if this is a sub-page)
sub_titlestringoptionalSubtitle of the page
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_create_folder#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.5 params

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.

NameTypeRequiredDescription
namestringrequiredName of the folder.
override_statusesbooleanoptionalWhether to override space statuses with folder-specific statuses.
space_idstringoptionalID of the space to create the folder in (preferred). Provide this instead of space_name if you already have it.
space_namestringoptionalName of the space to create the folder in. Use this when space_id is not available.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_create_list#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.9 params

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.

NameTypeRequiredDescription
namestringrequiredName of the list.
assigneenumberoptionalUser ID to assign the list to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.
contentstringoptionalDescription or content of the list.
due_datestringoptionalDue date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
prioritystringoptionalPriority value: 'urgent', 'high', 'normal', or 'low'.
space_idstringoptionalID of the space to create the list in. Provide this instead of space_name if you already have the ID.
space_namestringoptionalName of the space to create the list in. Alternative to space_id; one of them must be provided.
statusstringoptionalStatus of the list.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_create_list_in_folder#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.5 params

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.

NameTypeRequiredDescription
folder_idstringrequiredID of the folder to create the list in.
namestringrequiredName of the list.
contentstringoptionalDescription or content of the list.
statusstringoptionalStatus of the list (uses folder default if not specified).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_create_reminder#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).4 params

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

NameTypeRequiredDescription
due_datestringrequiredDue 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.
titlestringrequiredTitle for the reminder. Ask the user what they want to be reminded about.
descriptionstringoptionalOptional description with additional details for the reminder.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_create_task#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.15 params

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.

NameTypeRequiredDescription
list_idstringrequiredList ID. Use clickup_get_list to resolve names.
namestringrequiredTask name. Ask the user what they want to name the task.
assigneesarrayoptionalArray of assignee user IDs. Use clickup_resolve_assignees to convert emails, usernames, or "me" to user IDs if needed.
check_required_custom_fieldsbooleanoptionalFlag to check if all required custom fields are set before saving the task.
custom_fieldsarrayoptionalArray of custom field values to set on the task. Each object must have an 'id' and 'value' property.
due_datestringoptionalDue date in YYYY-MM-DD or YYYY-MM-DD HH:MM format
markdown_descriptionstringoptionalTask description in markdown format.
parentstringoptionalParent task ID to create as subtask.
prioritystringoptionalTask priority.
start_datestringoptionalStart date in YYYY-MM-DD or YYYY-MM-DD HH:MM format
statusstringoptionalOverride default status. Omit to use list defaults.
tagsarrayoptionalTag names (must already exist in the space).
task_typestringoptionalName 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_estimatestringoptionalTime estimate in minutes (e.g., '150' for 2h 30m).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_create_task_comment#[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.5 params

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

NameTypeRequiredDescription
comment_textstringrequiredComment content. Supports Markdown formatting.
task_idstringrequiredTask ID (supports custom IDs like 'DEV-1234')
assigneenumberoptionalUser ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.
notify_allbooleanoptionalWhether to notify all assignees. Default is false.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_delete_comment#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.2 params

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.

NameTypeRequiredDescription
comment_idstringrequiredID of the comment to delete. Use clickup_get_task_comments or clickup_get_threaded_comments to find the comment ID.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_delete_task#Delete a task by task_id (supports custom IDs like 'DEV-1234'). Always confirm the task_id with the user before deleting.2 params

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

NameTypeRequiredDescription
task_idstringrequiredTask ID to delete (supports custom IDs like 'DEV-1234')
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_download_task_attachment#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.3 params

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.

NameTypeRequiredDescription
attachment_idstringrequiredAttachment ID. List a task's attachments with clickup_get_task using include: ["attachments"].
task_idstringrequiredTask ID (supports custom IDs like 'DEV-1234')
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_filter_tasks#Retrieve tasks with combined filters (tags, lists, folders, spaces, statuses, assignees, due date range, completion date range). Multiple values within a filter use OR logic; across filters, AND logic applies. Best for filtering tasks by structured field values. For text/keyword search across all workspace content, use search instead. 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.16 params

Retrieve tasks with combined filters (tags, lists, folders, spaces, statuses, assignees, due date range, completion date range). Multiple values within a filter use OR logic; across filters, AND logic applies. Best for filtering tasks by structured field values. For text/keyword search across all workspace content, use search instead. 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.

NameTypeRequiredDescription
assigneesarrayoptionalFilter by assignee user IDs. Multiple IDs use OR logic. Use clickup_resolve_assignees to convert names/emails/"me" first.
date_closed_fromstringoptionalFilter tasks completed on or after. Format: YYYY-MM-DD
date_closed_tostringoptionalFilter tasks completed on or before. Format: YYYY-MM-DD
due_date_fromstringoptionalFilter tasks with due date on or after. Format: YYYY-MM-DD
due_date_tostringoptionalFilter tasks with due date on or before. Format: YYYY-MM-DD
folder_idsarrayoptionalFilter by Folder IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified folders).
include_closedbooleanoptionalInclude closed tasks in results
list_idsarrayoptionalFilter by List IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified lists).
order_bystringoptionalSort results by field
pagenumberoptional0-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.
reversebooleanoptionalReverse sort order
space_idsarrayoptionalFilter by Space IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified spaces).
statusesarrayoptionalFilter by task status names. Multiple statuses use OR logic (matches tasks with ANY of the specified statuses).
subtasksbooleanoptionalInclude subtasks in results (default: true)
tagsarrayoptionalFilter by tag names. Multiple tags use OR logic (matches tasks with ANY of the specified tags).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_find_member_by_name#Get a member in the ClickUp workspace by name or email. Returns the member object if found, or null if not found.2 params

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

NameTypeRequiredDescription
name_or_emailstringrequiredThe name or email of the member to find.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_bulk_tasks_time_in_status#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.2 params

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.

NameTypeRequiredDescription
task_idsarrayrequiredArray of task IDs to get time in status for (1-100 tasks). Works with both regular task IDs and custom IDs (like 'DEV-1234').
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_chat_channel_messages#Get messages for a chat channel. Messages with has_replies=true have threads fetchable via clickup_get_chat_message_replies. Supports pagination.5 params

Get messages for a chat channel. Messages with has_replies=true have threads fetchable via clickup_get_chat_message_replies. Supports pagination.

NameTypeRequiredDescription
channel_idstringrequiredID of the chat channel to get messages from.
content_formatstringoptionalResponse content format.
cursorstringoptionalCursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.
limitnumberoptionalMaximum number of messages to return (1-100).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_chat_channels#List chat channels in the workspace with pagination support.3 params

List chat channels in the workspace with pagination support.

NameTypeRequiredDescription
cursorstringoptionalCursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.
limitnumberoptionalMaximum number of channels to return (1-100).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_chat_message_replies#Get threaded replies for a chat message by message_id. Supports pagination.5 params

Get threaded replies for a chat message by message_id. Supports pagination.

NameTypeRequiredDescription
message_idstringrequiredID of the chat message to get replies from.
content_formatstringoptionalResponse content format.
cursorstringoptionalCursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.
limitnumberoptionalMaximum number of replies to return (1-100).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_current_time_entry#Get the currently running time entry, if any. No parameters needed.1 param

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

NameTypeRequiredDescription
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_custom_fields#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.5 params

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.

NameTypeRequiredDescription
folder_idstringoptionalFolder ID. Returns custom fields defined on this folder.
include_workspacebooleanoptionalIf true, returns workspace-level custom fields.
list_idstringoptionalList ID. Returns custom fields defined on this list.
space_idstringoptionalSpace ID. Returns custom fields defined on this space.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_document_pages#Get the full content of specific pages by page ID. Use list_document_pages first to discover available page IDs.4 params

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

NameTypeRequiredDescription
document_idstringrequiredID 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_idsarrayrequiredArray 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.
content_formatstringoptionalResponse content format.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_folder#Get folder details by folder_id or folder_name (+ space info). Use to resolve folder names to IDs.5 params

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

NameTypeRequiredDescription
folder_idstringoptionalID of the folder to retrieve.
folder_namestringoptionalName of the folder to retrieve. When using this, you must also provide space_id or space_name.
space_idstringoptionalID of the space containing the folder (required with folder_name).
space_namestringoptionalName of the space containing the folder (required with folder_name).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_list#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.3 params

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.

NameTypeRequiredDescription
list_idstringoptionalID of the list to retrieve.
list_namestringoptionalName of the list to retrieve. The tool will search for a list with this name.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_task#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.4 params

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.

NameTypeRequiredDescription
task_idstringrequiredTask ID (supports custom IDs like 'DEV-1234')
expand_statusesbooleanoptionalWhen 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.
includearrayoptionalSections 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).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_task_comments#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.4 params

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.

NameTypeRequiredDescription
task_idstringrequiredTask ID (supports custom IDs like 'DEV-1234')
startnumberoptionalTimestamp (in milliseconds) to start retrieving comments from. Used for pagination.
start_idstringoptionalComment ID to start from. Used together with start for pagination.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_task_time_in_status#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.2 params

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.

NameTypeRequiredDescription
task_idstringrequiredID 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.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_threaded_comments#Get threaded replies for a comment by comment_id. Use clickup_get_task_comments first to find comments with reply_count > 0.2 params

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

NameTypeRequiredDescription
comment_idstringrequiredID of the parent comment to get threaded replies for.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_time_entries#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.6 params

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.

NameTypeRequiredDescription
assigneearrayoptionalFilter 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_datestringoptionalEnd date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
is_billablebooleanoptionalFilter by billable status. Set to true for only billable entries, false for non-billable. Omit to get all entries.
start_datestringoptionalStart date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
task_idstringoptionalTask ID to scope entries to (supports custom IDs like 'DEV-1234'). Omit to query workspace-wide.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_workspace_hierarchy#Get workspace hierarchy (spaces, folders, lists) with pagination and depth control. Use only when you need the workspace structure — most tools resolve names automatically.5 params

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

NameTypeRequiredDescription
cursorstringoptionalPagination cursor from previous response. Use to fetch next page of spaces
limitnumberoptionalMaximum number of spaces to return per page (default: 10, max: 50)
max_depthstringoptionalMaximum depth of hierarchy to return: 0=spaces only, 1=spaces+folders, 2=spaces+folders+lists (default: 2)
space_idsarrayoptionalFilter to return only specific spaces by ID.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_get_workspace_members#List all members in the workspace. Most tools resolve assignees automatically — use only when you need the full member list.1 param

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

NameTypeRequiredDescription
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_list_document_pages#List page names and structure of a document (no content). Use get_document_pages to fetch full page content by page ID.3 params

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

NameTypeRequiredDescription
document_idstringrequiredID 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/.
max_page_depthnumberoptionalMaximum depth of pages to retrieve (-1 for unlimited)
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_merge_document#Merge one ClickUp document into another. The source document's pages are folded into the target document, then the SOURCE document is permanently DELETED — this is destructive and cannot be undone. `target_doc_id` survives; `source_doc_id` is consumed.3 params

Merge one ClickUp document into another. The source document's pages are folded into the target document, then the SOURCE document is permanently DELETED — this is destructive and cannot be undone. `target_doc_id` survives; `source_doc_id` is consumed.

NameTypeRequiredDescription
source_doc_idstringrequiredID of the source document whose pages are folded into the target. The source document is DELETED after the merge — this cannot be undone.
target_doc_idstringrequiredID of the target document that survives the merge and receives the source's pages (e.g. 'ad-909705'). In ClickUp doc URLs, the document_id is the first ID after /docs/ or /v/dc/.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_merge_document_page#Merge one document page into another. The source page's content is appended to the target page and its child pages are reparented under the target, then the SOURCE page is permanently DELETED — this is destructive and cannot be undone. By default the source page is taken from the same document as the target; set source_doc_id to merge a page from a different document in the same workspace.5 params

Merge one document page into another. The source page's content is appended to the target page and its child pages are reparented under the target, then the SOURCE page is permanently DELETED — this is destructive and cannot be undone. By default the source page is taken from the same document as the target; set source_doc_id to merge a page from a different document in the same workspace.

NameTypeRequiredDescription
source_page_idstringrequiredID of the source page to merge into the target. Its content is appended to the target and its child pages are reparented, then it is DELETED — this cannot be undone.
target_doc_idstringrequiredID of the document containing the target page (e.g. 'ad-909705'). In ClickUp doc URLs, the document_id is the first ID after /docs/ or /v/dc/.
target_page_idstringrequiredID of the target page that survives and receives the source page's content (e.g. 'ad-2675877').
source_doc_idstringoptionalID of the document the source page lives in. Defaults to target_doc_id. Set this to merge a page from a different document in the same workspace.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_merge_tasks#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').3 params

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

NameTypeRequiredDescription
source_task_idsarrayrequiredArray 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_idstringrequiredID 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').
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_move_task#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.3 params

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.

NameTypeRequiredDescription
list_idstringrequiredID 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_idstringrequiredID 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.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_remove_tag_from_task#Remove tag from task. Only removes tag-task association, tag remains in space.3 params

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

NameTypeRequiredDescription
tag_namestringrequiredName of the tag to remove from the task.
task_idstringrequiredID 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.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_remove_task_dependency#Remove a dependency between two tasks.4 params

Remove a dependency between two tasks.

NameTypeRequiredDescription
depends_onstringrequiredID of the task that was in the dependency relationship. Works with both regular task IDs and custom IDs (like 'DEV-1234').
task_idstringrequiredID 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.
typestringrequiredType of dependency to remove: 'waiting_on' or 'blocking'.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_remove_task_from_list#Remove a task from an additional list (cannot remove from home list). Requires the Tasks in Multiple Lists ClickApp to be enabled.3 params

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

NameTypeRequiredDescription
list_idstringrequiredID 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_idstringrequiredID 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.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_request_attachment_upload#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.3 params

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.

NameTypeRequiredDescription
task_idstringrequiredTask ID (supports custom IDs like 'DEV-1234')
file_namestringoptionalOptional file name override (include the extension). Defaults to the local file's own name.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_resolve_assignees#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.2 params

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.

NameTypeRequiredDescription
assigneesarrayrequiredArray of assignee names, emails, or "me" to resolve. Use "me" to refer to the currently authenticated user.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_search_reminders#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.8 params

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.

NameTypeRequiredDescription
cursorstringoptionalCursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results
due_date_statusstringoptionalFilter reminders by due date status (TODO, LATER, DELETED)
is_completedbooleanoptionalFilter to show only completed or incomplete reminders
is_overduebooleanoptionalFilter to show only overdue reminders
limitnumberoptionalMaximum number of reminders to return per page (default: 25, max: 100)
reminder_typestringoptionalFilter by type of reminder (ASSIGNED_COMMENT, UNANSWERED_MENTION, APPROVAL, SAVED, REMINDER)
sincestringoptionalFilter 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_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_send_chat_message#Send a message or threaded reply to a chat channel. Provide parent_message_id for threaded replies. Supports markdown and post types.11 params

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

NameTypeRequiredDescription
channel_idstringrequiredID 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.
contentstringrequiredMessage content to send (supports markdown).
assigneestringoptionalUser ID to assign the message to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.
content_formatstringoptionalFormat of the message content.
followersarrayoptionalArray 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_assigneestringoptionalGroup ID to assign the message to.
parent_message_idstringoptionalID 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_idstringoptionalSubtype ID for the post (required if type is 'post').
post_titlestringoptionalTitle for the post (required if type is 'post').
typestringoptionalType of message to send.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_start_time_tracking#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.5 params

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.

NameTypeRequiredDescription
task_idstringrequiredTask ID (supports custom IDs like 'DEV-1234')
billablebooleanoptionalWhether this time is billable. Default is workspace setting.
descriptionstringoptionalDescription for the time entry. Keep short and simple, or omit for best compatibility.
tagsarrayoptionalArray of tag names to assign to the time entry.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_stop_time_tracking#Stop the currently running time tracker. Supports description and tags. Returns the completed time entry details.3 params

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

NameTypeRequiredDescription
descriptionstringoptionalDescription to update or add to the time entry.
tagsarrayoptionalArray of tag names to assign to the time entry.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_update_comment#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.5 params

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.

NameTypeRequiredDescription
comment_idstringrequiredID of the comment to update. Use clickup_get_task_comments or clickup_get_threaded_comments to find the comment ID.
assigneenumberoptionalUser ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.
comment_textstringoptionalNew comment content that replaces the existing text. Supports Markdown formatting. To @mention a user, write @[Name](user_id) inline — user_id MUST be a numeric ClickUp user id from clickup_resolve_assignees. Comments with mentions post as plain text (no Markdown).
resolvedbooleanoptionalMark the comment as resolved (true) or unresolved (false).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_update_document_page#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.8 params

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.

NameTypeRequiredDescription
document_idstringrequiredID 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_idstringrequiredID of the page to update (e.g. 'ad-2675877'). In ClickUp doc URLs, this is the second ID after /docs/ or /v/dc/.
contentstringoptionalNew 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_modestringoptionalHow 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.
content_formatstringoptionalThe format of the page content
namestringoptionalNew name for the page
sub_titlestringoptionalNew subtitle for the page
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_update_folder#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.4 params

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.

NameTypeRequiredDescription
folder_idstringrequiredID of the folder to update.
namestringoptionalNew name for the folder.
override_statusesbooleanoptionalWhether to override space statuses with folder-specific statuses.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_update_list#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.5 params

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.

NameTypeRequiredDescription
list_idstringrequiredID of the list to update.
contentstringoptionalNew description or content for the list.
namestringoptionalNew name for the list.
statusstringoptionalNew status for the list.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_update_reminder#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.6 params

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.

NameTypeRequiredDescription
reminder_idstringrequiredThe unique identifier (KSUID) of the reminder to update.
descriptionstringoptionalNew description for the reminder.
due_datestringoptionalNew 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_completedbooleanoptionalSet to true to mark the reminder as completed, false to mark as incomplete.
titlestringoptionalNew title for the reminder.
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.
clickupmcp_clickup_update_task#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).12 params

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

NameTypeRequiredDescription
task_idstringrequiredTask ID (supports custom IDs like 'DEV-1234')
assigneesarrayoptionalArray of assignee user IDs. Use clickup_resolve_assignees to convert emails, usernames, or "me" to user IDs if needed.
custom_fieldsarrayoptionalArray of custom field values to set on the task. Each object must have an 'id' and 'value' property.
due_datestringoptionalYYYY-MM-DD or YYYY-MM-DD HH:MM format. Pass 'none' to clear. Omit to leave unchanged.
markdown_descriptionstringoptionalTask description in markdown format.
namestringoptionalNew task name.
prioritystringoptionalSet priority, or 'none' to clear. Omit to leave unchanged.
start_datestringoptionalYYYY-MM-DD or YYYY-MM-DD HH:MM format. Pass 'none' to clear. Omit to leave unchanged.
statusstringoptionalNew status (must be valid for the task's list).
task_typestringoptionalTo 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_estimatestringoptionalTime estimate in minutes (e.g., '150' for 2h 30m).
workspace_idstringoptionalWorkspace ID (digits only). Only needed when you have multiple workspaces.