Skip to main content
ClickUp MCP logo
  • Category: model context protocol
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 58
  • Triggers: 0
  • Slug: CLICKUP_MCP
  • Version: 20261018_00

Tools

Slug: CLICKUP_MCP_CLICKUP_ADD_TAG_TO_TASKAdd existing tag to task. Tag must exist in space. Note: Will fail if tag doesn’t exist.

Input Parameters

string
required
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.
string
required
Name of the tag to add to the task. The tag must already exist in the space.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
string
required
string
Custom task ID (e.g., ‘DEV-1234’) if the workspace has custom IDs enabled, otherwise null.
Slug: CLICKUP_MCP_CLICKUP_ADD_TASK_DEPENDENCYSet 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.

Input Parameters

string ("waiting_on" | "blocking")
required
Type of dependency to add: ‘waiting_on’ or ‘blocking’.
string
required
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.
string
required
ID of the task that task_id depends on or is blocking. Works with regular and custom IDs.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
Slug: CLICKUP_MCP_CLICKUP_ADD_TASK_TO_LISTAdd a task to an additional list (keeps current home list). Requires the Tasks in Multiple Lists ClickApp to be enabled.

Input Parameters

string
required
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.
string
required
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.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
Slug: CLICKUP_MCP_CLICKUP_ADD_TIME_ENTRYAdd 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.

Input Parameters

array
Array of tag names to assign to the time entry.
string
required
Start time in YYYY-MM-DD HH:MM format (e.g., ‘2025-01-15 09:30’). Time is required for time tracking entries.
string
required
Task ID (supports custom IDs like ‘DEV-1234’)
boolean
Whether this time is billable. Default is workspace setting.
string
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.
string
End time in YYYY-MM-DD HH:MM format (e.g., ‘2025-01-15 11:00’). Time is required for time tracking entries.
string
Description for the time entry. Keep short and simple, or omit for best compatibility.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
required
string
required
boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_ATTACH_TASK_FILEAttach 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.

Input Parameters

string
required
Task ID (supports custom IDs like ‘DEV-1234’)
string
URL to download the file from (must start with http:// or https://).
string
Base64-encoded content of the file (without the data URL prefix).
string
Name of the file to be attached (include the extension). Required when using file_data.
string
Authorization header to use when downloading from the web URL.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
Download URL for the attached file.
string
boolean
required
string
required
string
Custom task ID (e.g., ‘DEV-1234’) if the workspace has custom IDs enabled, otherwise null.
string
string
required
Slug: CLICKUP_MCP_CLICKUP_CREATE_COMMENTCreate 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.

Input Parameters

number
User ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or “me” to user ID if needed.
string
ID of the entity to comment on.
boolean
Whether to notify all assignees. Default is false.
string ("task" | "list" | "view")
Entity type to comment on. Use with entity_id.
string
ID of a parent comment to reply to. When provided, the comment is posted as a threaded reply instead of a top-level comment.
string
required
Comment content. Supports Markdown formatting. To @mention a user, write @Name inline, e.g. ‘Hey @Jane, please review’ — user_id MUST be a numeric ClickUp user id from clickup_resolve_assignees. Comments with mentions post as plain text (no Markdown).
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_CREATE_DOCUMENTCreate a document in a ClickUp space, folder, or list. Requires name, parent info, visibility and create_page flag.

Input Parameters

string
required
Name and Title of the document
object
required
Parent container information
string ("PUBLIC" | "PRIVATE" | "PERSONAL" | "HIDDEN")
required
Document visibility setting
boolean
required
Whether to create an initial blank page
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
string
required
Slug: CLICKUP_MCP_CLICKUP_CREATE_DOCUMENT_PAGECreate a new page in a ClickUp document.

Input Parameters

string
required
Name and title of the page
string
required
Content of the page
string
Subtitle of the page
string
required
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/.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string ("text/md" | "text/plain")
The format of the page content
string
ID of the parent page (if this is a sub-page)

Output

string
required
string
required
string
required
boolean
required
Slug: CLICKUP_MCP_CLICKUP_CREATE_FOLDERCreate 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.

Input Parameters

string
required
Name of the folder.
string
ID of the space to create the folder in (preferred). Provide this instead of space_name if you already have it.
string
Name of the space to create the folder in. Use this when space_id is not available.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
boolean
Whether to override space statuses with folder-specific statuses.

Output

boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_CREATE_LISTCreate a list in a ClickUp space. Requires name and space_name or space_id. For lists in folders, use clickup_create_list_in_folder.

Input Parameters

string
required
Name of the list.
string
Status of the list.
string
Description or content of the list.
number
User ID to assign the list to. Use clickup_resolve_assignees to convert email, username, or “me” to user ID if needed.
string
Due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
string ("urgent" | "high" | "normal" | "low")
Priority value: ‘urgent’, ‘high’, ‘normal’, or ‘low’.
string
ID of the space to create the list in. Provide this instead of space_name if you already have the ID.
string
Name of the space to create the list in. Alternative to space_id; one of them must be provided.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
required
boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_CREATE_LIST_IN_FOLDERCreate 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.

Input Parameters

string
required
Name of the list.
string
Status of the list (uses folder default if not specified).
string
Description or content of the list.
string
required
ID of the folder to create the list in.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
required
boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_CREATE_REMINDERCreate 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).

Input Parameters

string
required
Title for the reminder. Ask the user what they want to be reminded about.
string
required
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.
string
Optional description with additional details for the reminder.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
Whether the reminder was created successfully
string
required
Unique identifier for the created reminder
Slug: CLICKUP_MCP_CLICKUP_CREATE_TASKCreate 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.

Input Parameters

string
required
Task name. Ask the user what they want to name the task.
array
Tag names (must already exist in the space).
string
Parent task ID to create as subtask.
string
Override default status. Omit to use list defaults.
string
required
List ID. Use clickup_get_list to resolve names.
string
Due date in YYYY-MM-DD or YYYY-MM-DD HH:MM format
string ("urgent" | "high" | "normal" | "low")
array
Array of assignee user IDs. Use clickup_resolve_assignees to convert emails, usernames, or “me” to user IDs if needed.
string
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.
string
Start date in YYYY-MM-DD or YYYY-MM-DD HH:MM format
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
array
Array of custom field values to set on the task. Each object must have an ‘id’ and ‘value’ property.
string
Time estimate in minutes (e.g., ‘150’ for 2h 30m).
string
Task description in markdown format.
boolean
Flag to check if all required custom fields are set before saving the task.

Output

boolean
required
string
required
string
required
string
Custom task ID (e.g., ‘DEV-1234’) if the workspace has custom IDs enabled, otherwise null.
Slug: CLICKUP_MCP_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.

Input Parameters

string
required
Task ID (supports custom IDs like ‘DEV-1234’)
number
User ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or “me” to user ID if needed.
boolean
Whether to notify all assignees. Default is false.
string
required
Comment content. Supports Markdown formatting.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_DELETE_COMMENTDelete a comment by comment_id. This cannot be undone. Use clickup_get_task_comments or clickup_get_threaded_comments to find the comment ID.

Input Parameters

string
required
ID of the comment to delete. Use clickup_get_task_comments or clickup_get_threaded_comments to find the comment ID.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_DELETE_TASKDelete a task by task_id (supports custom IDs like ‘DEV-1234’). Always confirm the task_id with the user before deleting.

Input Parameters

string
required
Task ID to delete (supports custom IDs like ‘DEV-1234’)
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
string
Custom task ID (e.g., ‘DEV-1234’) if the workspace has custom IDs enabled, otherwise null.
Slug: CLICKUP_MCP_CLICKUP_DOWNLOAD_TASK_ATTACHMENTDownload 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.

Input Parameters

string
required
Task ID (supports custom IDs like ‘DEV-1234’)
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string
required
Attachment ID. List a task’s attachments with clickup_get_task using include: [“attachments”].

Output

string
required
Download URL. Short-lived, and single-use on workspaces with private attachments enabled (~5 minute expiry). Fetch it immediately and exactly once; do not preview, HEAD-request, retry, or store it. If the download fails or the URL expired, call clickup_download_task_attachment again for a fresh URL.
number
File size in bytes. Absent when the upstream API does not report one (e.g. legacy or link attachments).
string
required
boolean
required
string
required
Resolved task ID.
string
MIME type. Absent when the upstream API does not report one (e.g. legacy attachments).
string
Custom task ID (e.g., ‘DEV-1234’) if the workspace has custom IDs enabled, otherwise null.
string
File extension. Absent when the attachment has none (e.g. extension-less files).
string
required
Handling instructions for the download URL.
string
required
Slug: CLICKUP_MCP_CLICKUP_FILTER_TASKSRetrieve 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.

Input Parameters

number
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.
array
Filter by tag names. Multiple tags use OR logic (matches tasks with ANY of the specified tags).
boolean
Reverse sort order
array
Filter by List IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified lists).
string ("id" | "created" | "updated" | "due_date")
Sort results by field
array
Filter by task status names. Multiple statuses use OR logic (matches tasks with ANY of the specified statuses).
boolean
Include subtasks in results (default: true)
array
Filter by assignee user IDs. Multiple IDs use OR logic. Use clickup_resolve_assignees to convert names/emails/“me” first.
array
Filter by Space IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified spaces).
array
Filter by Folder IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified folders).
string
Filter tasks with due date on or before. Format: YYYY-MM-DD
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string
Filter tasks with due date on or after. Format: YYYY-MM-DD
string
Filter tasks completed on or before. Format: YYYY-MM-DD
boolean
Include closed tasks in results
string
Filter tasks completed on or after. Format: YYYY-MM-DD

Output

number
required
0-indexed page number that was returned.
number
required
Number of tasks returned on this page.
array
required
string
Informational message, e.g. guidance to fetch the next page when more results are available.
boolean
required
True when more tasks match these filters beyond this page. When true, call filter_tasks again with page set to next_page to retrieve them; do not assume this page is the complete set.
string
required
The page value to request next to continue paginating, or null when this is the last page.
Slug: CLICKUP_MCP_CLICKUP_FIND_MEMBER_BY_NAMEGet a member in the ClickUp workspace by name or email. Returns the member object if found, or null if not found.

Input Parameters

string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string
required
The name or email of the member to find.

Output

string
required
Found member or null
Slug: CLICKUP_MCP_CLICKUP_GET_BULK_TASKS_TIME_IN_STATUSGet 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.

Input Parameters

array
required
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’).
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

object
required
number
required
Slug: CLICKUP_MCP_CLICKUP_GET_CHAT_CHANNEL_MESSAGESGet messages for a chat channel. Messages with has_replies=true have threads fetchable via clickup_get_chat_message_replies. Supports pagination.

Input Parameters

number
Maximum number of messages to return (1-100).
string
Cursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.
string
required
ID of the chat channel to get messages from.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string ("text/plain" | "text/md")
Response content format.

Output

boolean
required
array
required
string
required
number
required
Slug: CLICKUP_MCP_CLICKUP_GET_CHAT_CHANNELSList chat channels in the workspace with pagination support.

Input Parameters

number
Maximum number of channels to return (1-100).
string
Cursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

array
required
boolean
required
string
required
number
required
Slug: CLICKUP_MCP_CLICKUP_GET_CHAT_MESSAGE_REPLIESGet threaded replies for a chat message by message_id. Supports pagination.

Input Parameters

number
Maximum number of replies to return (1-100).
string
Cursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.
string
required
ID of the chat message to get replies from.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string ("text/plain" | "text/md")
Response content format.

Output

array
required
boolean
required
string
required
number
required
Slug: CLICKUP_MCP_CLICKUP_GET_CURRENT_TIME_ENTRYGet the currently running time entry, if any. No parameters needed.

Input Parameters

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

Output

string
required
boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_GET_CUSTOM_FIELDSGet 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.

Input Parameters

string
List ID. Returns custom fields defined on this list.
string
Space ID. Returns custom fields defined on this space.
string
Folder ID. Returns custom fields defined on this folder.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
boolean
If true, returns workspace-level custom fields.

Output

array
Error messages for scopes that failed to fetch. Present only when some (but not all) scopes failed.
array
array
array
array
Slug: CLICKUP_MCP_CLICKUP_GET_DOCUMENT_PAGESGet the full content of specific pages by page ID. Use list_document_pages first to discover available page IDs.

Input Parameters

array
required
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.
string
required
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/.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string ("text/plain" | "text/md")
Response content format.

Output

array
required
Document page contents
Slug: CLICKUP_MCP_CLICKUP_GET_FOLDERGet folder details by folder_id or folder_name (+ space info). Use to resolve folder names to IDs.

Input Parameters

string
ID of the space containing the folder (required with folder_name).
string
ID of the folder to retrieve.
string
Name of the space containing the folder (required with folder_name).
string
Name of the folder to retrieve. When using this, you must also provide space_id or space_name.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
required
string
required
object
required
Slug: CLICKUP_MCP_CLICKUP_GET_LISTGet list details by list_id or list_name. Returns id, name, content, space info, and configured statuses. Use to resolve list names to IDs.

Input Parameters

string
ID of the list to retrieve.
string
Name of the list to retrieve. The tool will search for a list with this name.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
required
string
required
string
required
object
required
string
array
required
Full set of statuses configured on the list (including any inherited from the parent folder or space). Use this to discover which status values can be assigned via update_task.
Slug: CLICKUP_MCP_CLICKUP_GET_TASKRetrieve 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.

Input Parameters

array
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).
string
required
Task ID (supports custom IDs like ‘DEV-1234’)
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
boolean
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.
Slug: CLICKUP_MCP_CLICKUP_GET_TASK_COMMENTSGet task comments with reply_count per comment. Use clickup_get_threaded_comments for replies when reply_count > 0. Supports pagination via start/start_id.

Input Parameters

number
Timestamp (in milliseconds) to start retrieving comments from. Used for pagination.
string
required
Task ID (supports custom IDs like ‘DEV-1234’)
string
Comment ID to start from. Used together with start for pagination.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

number
required
Total comment count
array
required
Array of task comments
Slug: CLICKUP_MCP_CLICKUP_GET_TASK_TIME_IN_STATUSGet 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.

Input Parameters

string
required
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.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
required
object
required
array
required
Slug: CLICKUP_MCP_CLICKUP_GET_THREADED_COMMENTSGet threaded replies for a comment by comment_id. Use clickup_get_task_comments first to find comments with reply_count > 0.

Input Parameters

string
required
ID of the parent comment to get threaded replies for.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

number
required
array
required
Slug: CLICKUP_MCP_CLICKUP_GET_TIME_ENTRIESGet 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.

Input Parameters

string
Task ID to scope entries to (supports custom IDs like ‘DEV-1234’). Omit to query workspace-wide.
array
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.
string
End date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
string
Start date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
boolean
Filter by billable status. Set to true for only billable entries, false for non-billable. Omit to get all entries.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

array
required
object
required
Slug: CLICKUP_MCP_CLICKUP_GET_WORKSPACE_HIERARCHYGet workspace hierarchy (spaces, folders, lists) with pagination and depth control. Use only when you need the workspace structure — most tools resolve names automatically.

Input Parameters

number
Maximum number of spaces to return per page (default: 10, max: 50)
string
Pagination cursor from previous response. Use to fetch next page of spaces
string ("0" | "1" | "2")
Maximum depth of hierarchy to return: 0=spaces only, 1=spaces+folders, 2=spaces+folders+lists (default: 2)
array
Filter to return only specific spaces by ID.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
Whether there are more spaces to fetch
object
required
Workspace hierarchy tree containing paginated spaces
string
required
Cursor for next page of spaces, or null if no more pages
number
required
Total number of spaces in workspace (after filtering if space_ids provided)
Slug: CLICKUP_MCP_CLICKUP_GET_WORKSPACE_MEMBERSList all members in the workspace. Most tools resolve assignees automatically — use only when you need the full member list.

Input Parameters

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

Output

array
required
List of workspace members
Slug: CLICKUP_MCP_CLICKUP_LIST_DOCUMENT_PAGESList page names and structure of a document (no content). Use get_document_pages to fetch full page content by page ID.

Input Parameters

string
required
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/.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
number
Maximum depth of pages to retrieve (-1 for unlimited)

Output

array
required
Document page listing
Slug: CLICKUP_MCP_CLICKUP_MERGE_DOCUMENTMerge 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.

Input Parameters

string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string
required
ID of the source document whose pages are folded into the target. The source document is DELETED after the merge — this cannot be undone.
string
required
ID 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/.

Output

boolean
required
string
required
string
required
Slug: CLICKUP_MCP_CLICKUP_MERGE_DOCUMENT_PAGEMerge 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.

Input Parameters

string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string
ID 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.
string
required
ID 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/.
string
required
ID 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.
string
required
ID of the target page that survives and receives the source page’s content (e.g. ‘ad-2675877’). In ClickUp doc URLs, the page_id is the second ID after /docs/ or /v/dc/.

Output

boolean
required
string
string
required
string
required
string
required
Slug: CLICKUP_MCP_CLICKUP_MERGE_TASKSMerge 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’).

Input Parameters

string
required
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’).
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
array
required
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’).

Output

boolean
required
string
required
The ID of the surviving target task.
Slug: CLICKUP_MCP_CLICKUP_MOVE_TASKMove a task to a new home list. Requires task_id and list_id (supports custom IDs). Use clickup_get_list to resolve list names.

Input Parameters

string
required
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.
string
required
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.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
string
Custom task ID (e.g., ‘DEV-1234’) if the workspace has custom IDs enabled, otherwise null.
string
required
Slug: CLICKUP_MCP_CLICKUP_REMOVE_TAG_FROM_TASKRemove tag from task. Only removes tag-task association, tag remains in space.

Input Parameters

string
required
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.
string
required
Name of the tag to remove from the task.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
string
required
string
Custom task ID (e.g., ‘DEV-1234’) if the workspace has custom IDs enabled, otherwise null.
Slug: CLICKUP_MCP_CLICKUP_REMOVE_TASK_DEPENDENCYRemove a dependency between two tasks.

Input Parameters

string ("waiting_on" | "blocking")
required
Type of dependency to remove: ‘waiting_on’ or ‘blocking’.
string
required
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.
string
required
ID of the task that was in the dependency relationship. Works with both regular task IDs and custom IDs (like ‘DEV-1234’).
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
Slug: CLICKUP_MCP_CLICKUP_REMOVE_TASK_FROM_LISTRemove a task from an additional list (cannot remove from home list). Requires the Tasks in Multiple Lists ClickApp to be enabled.

Input Parameters

string
required
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.
string
required
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.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
Slug: CLICKUP_MCP_CLICKUP_REQUEST_ATTACHMENT_UPLOADGet 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.

Input Parameters

string
required
Task ID (supports custom IDs like ‘DEV-1234’)
string
Optional file name override (include the extension). Defaults to the local file’s own name.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
Resolved task ID the upload is bound to.
string
Filename to give the uploaded attachment. When present, set it as the filename of the multipart “attachment” part; otherwise the local file’s own name is used.
string
required
ISO 8601 expiry of the upload ticket.
string
required
URL the file must be POSTed to.
string
required
HTTP method for the upload request (always POST).
string
required
How to complete the upload.
string
required
Upload ticket. Send it in the X-Upload-Ticket request header.
string
required
multipart/form-data field name for the file (always “attachment”).
Slug: CLICKUP_MCP_CLICKUP_RESOLVE_ASSIGNEESConvert 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.

Input Parameters

array
required
Array of assignee names, emails, or “me” to resolve. Use “me” to refer to the currently authenticated user.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

array
required
Array of resolved user IDs. Null entries indicate assignees that could not be resolved.
Slug: CLICKUP_MCP_CLICKUP_SEARCHSearch 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.

Input Parameters

array
Sort criteria for results. Can specify multiple sort fields in priority order
number
Maximum number of results to return per page (for pagination)
string
Pagination cursor from previous response. Use to fetch next page of results
object
Filters to refine search results by various criteria
string
Search query string. Use specific keywords to find items
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

array
required
Array of formatted search results
string
required
A high-level overview of the search results including count and types found
string
required
Pagination cursor for fetching next page, or null if no more results
Slug: CLICKUP_MCP_CLICKUP_SEARCH_REMINDERSSearch 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.

Input Parameters

number
Maximum number of reminders to return per page (default: 25, max: 100)
string
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’)
string
Cursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results
boolean
Filter to show only overdue reminders
boolean
Filter to show only completed or incomplete reminders
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string ("ASSIGNED_COMMENT" | "UNANSWERED_MENTION" | "APPROVAL" | "SAVED" | "REMINDER")
Filter by type of reminder (ASSIGNED_COMMENT, UNANSWERED_MENTION, APPROVAL, SAVED, REMINDER)
string ("TODO" | "LATER" | "DELETED")
Filter reminders by due date status (TODO, LATER, DELETED)

Output

boolean
required
Whether there are more results available
array
required
Array of reminder results
string
required
Cursor for fetching next page of results, or null if no more results
number
required
Total number of reminders returned in this response
Slug: CLICKUP_MCP_CLICKUP_SEND_CHAT_MESSAGESend a message or threaded reply to a chat channel. Provide parent_message_id for threaded replies. Supports markdown and post types.

Input Parameters

string ("message" | "post")
Type of message to send.
string
required
Message content to send (supports markdown).
string
User ID to assign the message to. Use clickup_resolve_assignees to convert email, username, or “me” to user ID if needed.
array
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.
string
required
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.
string
Title for the post (required if type is ‘post’).
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string ("text/md" | "text/plain")
Format of the message content.
string
Group ID to assign the message to.
string
Subtype ID for the post (required if type is ‘post’).
string
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.

Output

boolean
required
string
required
string
required
Slug: CLICKUP_MCP_CLICKUP_START_TIME_TRACKINGStart 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.

Input Parameters

array
Array of tag names to assign to the time entry.
string
required
Task ID (supports custom IDs like ‘DEV-1234’)
boolean
Whether this time is billable. Default is workspace setting.
string
Description for the time entry. Keep short and simple, or omit for best compatibility.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
required
string
required
boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_STOP_TIME_TRACKINGStop the currently running time tracker. Supports description and tags. Returns the completed time entry details.

Input Parameters

array
Array of tag names to assign to the time entry.
string
Description to update or add to the time entry.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
required
boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_UPDATE_COMMENTEdit 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.

Input Parameters

number
User ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or “me” to user ID if needed.
boolean
Mark the comment as resolved (true) or unresolved (false).
string
required
ID of the comment to update. Use clickup_get_task_comments or clickup_get_threaded_comments to find the comment ID.
string
New comment content that replaces the existing text. Supports Markdown formatting. To @mention a user, write @Name inline — user_id MUST be a numeric ClickUp user id from clickup_resolve_assignees. Comments with mentions post as plain text (no Markdown).
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_UPDATE_DOCUMENT_PAGEUpdate 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.

Input Parameters

string
New name for the page
string
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.
string
required
ID of the page to update (e.g. ‘ad-2675877’). In ClickUp doc URLs, this is the second ID after /docs/ or /v/dc/.
string
New subtitle for the page
string
required
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/.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
string ("text/md" | "text/plain")
The format of the page content
string ("replace" | "append" | "prepend")
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.

Output

string
required
boolean
required
Slug: CLICKUP_MCP_CLICKUP_UPDATE_FOLDERUpdate 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.

Input Parameters

string
New name for the folder.
string
required
ID of the folder to update.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
boolean
Whether to override space statuses with folder-specific statuses.

Output

boolean
required
string
required
Slug: CLICKUP_MCP_CLICKUP_UPDATE_LISTUpdate 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.

Input Parameters

string
New name for the list.
string
New status for the list.
string
New description or content for the list.
string
required
ID of the list to update.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

string
required
boolean
required
Slug: CLICKUP_MCP_CLICKUP_UPDATE_REMINDERUpdate 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.

Input Parameters

string
New title for the reminder.
string
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.
string
New description for the reminder.
string
required
The unique identifier (KSUID) of the reminder to update.
boolean
Set to true to mark the reminder as completed, false to mark as incomplete.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.

Output

boolean
required
Whether the reminder was updated successfully
string
required
Unique identifier of the updated reminder
Slug: CLICKUP_MCP_CLICKUP_UPDATE_TASKUpdate 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).

Input Parameters

string
string
New status (must be valid for the task’s list).
string
required
Task ID (supports custom IDs like ‘DEV-1234’)
string
YYYY-MM-DD or YYYY-MM-DD HH:MM format. Pass ‘none’ to clear. Omit to leave unchanged.
string ("urgent" | "high" | "normal" | "low" | "none")
Set priority, or ‘none’ to clear. Omit to leave unchanged.
array
Array of assignee user IDs. Use clickup_resolve_assignees to convert emails, usernames, or “me” to user IDs if needed.
string
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.
string
YYYY-MM-DD or YYYY-MM-DD HH:MM format. Pass ‘none’ to clear. Omit to leave unchanged.
string
Workspace ID (digits only). Only needed when you have multiple workspaces.
array
Array of custom field values to set on the task. Each object must have an ‘id’ and ‘value’ property.
string
Time estimate in minutes (e.g., ‘150’ for 2h 30m).
string
Task description in markdown format.

Output

boolean
required
string
required
string
required
string
Custom task ID (e.g., ‘DEV-1234’) if the workspace has custom IDs enabled, otherwise null.