> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp MCP

> ClickUp MCP lets agents search and manage tasks, lists, folders, docs, comments, chat, and time-tracking workflows in a ClickUp workspace.

![ClickUp MCP logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/clickup_mcp.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=3b8c35b41d8d3b04fe50fc5dad0ef006)

* **Category:** model context protocol
* **Auth:** DCR\_OAUTH
* **Composio-managed OAuth available?** No
* **Tools:** 58
* **Triggers:** 0
* **Slug:** `CLICKUP_MCP`
* **Version:** 20261018\_00

## Tools

> [accordion] Clickup add tag to task
>
> **Slug:** `CLICKUP_MCP_CLICKUP_ADD_TAG_TO_TASK`
>
> Add existing tag to task. Tag must exist in space. Note: Will fail if tag doesn't exist.
>
> #### Input Parameters
>
> **task\_id** `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.
>
> **tag\_name** `string` *required*
>
> Name of the tag to add to the task. The tag must already exist in the space.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **task\_id** `string` *required*
>
> **tag\_name** `string` *required*
>
> **custom\_id** `string`
>
> Custom task ID (e.g., 'DEV-1234') if the workspace has custom IDs enabled, otherwise null.

> [accordion] Clickup add task dependency
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **type** `string ("waiting_on" | "blocking")` *required*
>
> Type of dependency to add: 'waiting\_on' or 'blocking'.
>
> **task\_id** `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.
>
> **depends\_on** `string` *required*
>
> ID of the task that task\_id depends on or is blocking. Works with regular and custom IDs.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*

> [accordion] Clickup add task link
>
> **Slug:** `CLICKUP_MCP_CLICKUP_ADD_TASK_LINK`
>
> Link two tasks together. Creates a bidirectional association with no ordering or blocking. For blocking/dependency relationships, use add\_task\_dependency instead.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> ID of the task to link from. Works with regular and custom IDs (like 'DEV-1234').
>
> **links\_to** `string` *required*
>
> ID of the task to link to. Works with regular and custom IDs.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*

> [accordion] Clickup add task to list
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **list\_id** `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.
>
> **task\_id** `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.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*

> [accordion] Clickup add time entry
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **tags** `array`
>
> Array of tag names to assign to the time entry.
>
> **start** `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.
>
> **task\_id** `string` *required*
>
> Task ID (supports custom IDs like 'DEV-1234')
>
> **billable** `boolean`
>
> Whether this time is billable. Default is workspace setting.
>
> **duration** `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.
>
> **end\_time** `string`
>
> End time in YYYY-MM-DD HH:MM format (e.g., '2025-01-15 11:00'). Time is required for time tracking entries.
>
> **description** `string`
>
> Description for the time entry. Keep short and simple, or omit for best compatibility.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **taskId** `string` *required*
>
> **message** `string` *required*
>
> **success** `boolean` *required*
>
> **timeEntry** `string` *required*

> [accordion] Clickup attach task file
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Task ID (supports custom IDs like 'DEV-1234')
>
> **file\_url** `string`
>
> URL to download the file from (must start with http\:// or https\://).
>
> **file\_data** `string`
>
> Base64-encoded content of the file (without the data URL prefix).
>
> **file\_name** `string`
>
> Name of the file to be attached (include the extension). Required when using file\_data.
>
> **auth\_header** `string`
>
> Authorization header to use when downloading from the web URL.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **url** `string`
>
> Download URL for the attached file.
>
> **title** `string`
>
> **success** `boolean` *required*
>
> **task\_id** `string` *required*
>
> **custom\_id** `string`
>
> Custom task ID (e.g., 'DEV-1234') if the workspace has custom IDs enabled, otherwise null.
>
> **extension** `string`
>
> **attachment\_id** `string` *required*

> [accordion] Clickup create comment
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **assignee** `number`
>
> User ID to assign the comment to. Use clickup\_resolve\_assignees to convert email, username, or "me" to user ID if needed.
>
> **entity\_id** `string`
>
> ID of the entity to comment on.
>
> **notify\_all** `boolean`
>
> Whether to notify all assignees. Default is false.
>
> **entity\_type** `string ("task" | "list" | "view")`
>
> Entity type to comment on. Use with entity\_id.
>
> **reply\_to\_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.
>
> **comment\_text** `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).
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **comment\_id** `string` *required*

> [accordion] Clickup create document
>
> **Slug:** `CLICKUP_MCP_CLICKUP_CREATE_DOCUMENT`
>
> Create a document in a ClickUp space, folder, or list. Requires name, parent info, visibility and create\_page flag.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name and Title of the document
>
> **parent** `object` *required*
>
> Parent container information
>
> **visibility** `string ("PUBLIC" | "PRIVATE" | "PERSONAL" | "HIDDEN")` *required*
>
> Document visibility setting
>
> **create\_page** `boolean` *required*
>
> Whether to create an initial blank page
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **document\_id** `string` *required*
>
> **document\_url** `string` *required*

> [accordion] Clickup create document page
>
> **Slug:** `CLICKUP_MCP_CLICKUP_CREATE_DOCUMENT_PAGE`
>
> Create a new page in a ClickUp document.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name and title of the page
>
> **content** `string` *required*
>
> Content of the page
>
> **sub\_title** `string`
>
> Subtitle of the page
>
> **document\_id** `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/.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **content\_format** `string ("text/md" | "text/plain")`
>
> The format of the page content
>
> **parent\_page\_id** `string`
>
> ID of the parent page (if this is a sub-page)
>
> #### Output
>
> **name** `string` *required*
>
> **doc\_id** `string` *required*
>
> **page\_id** `string` *required*
>
> **success** `boolean` *required*

> [accordion] Clickup create folder
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the folder.
>
> **space\_id** `string`
>
> ID of the space to create the folder in (preferred). Provide this instead of space\_name if you already have it.
>
> **space\_name** `string`
>
> Name of the space to create the folder in. Use this when space\_id is not available.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **override\_statuses** `boolean`
>
> Whether to override space statuses with folder-specific statuses.
>
> #### Output
>
> **success** `boolean` *required*
>
> **folder\_id** `string` *required*

> [accordion] Clickup create list
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the list.
>
> **status** `string`
>
> Status of the list.
>
> **content** `string`
>
> Description or content of the list.
>
> **assignee** `number`
>
> User ID to assign the list to. Use clickup\_resolve\_assignees to convert email, username, or "me" to user ID if needed.
>
> **due\_date** `string`
>
> Due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
>
> **priority** `string ("urgent" | "high" | "normal" | "low")`
>
> Priority value: 'urgent', 'high', 'normal', or 'low'.
>
> **space\_id** `string`
>
> ID of the space to create the list in. Provide this instead of space\_name if you already have the ID.
>
> **space\_name** `string`
>
> Name of the space to create the list in. Alternative to space\_id; one of them must be provided.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **list\_id** `string` *required*
>
> **success** `boolean` *required*
>
> **list\_url** `string` *required*

> [accordion] Clickup create list in folder
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the list.
>
> **status** `string`
>
> Status of the list (uses folder default if not specified).
>
> **content** `string`
>
> Description or content of the list.
>
> **folder\_id** `string` *required*
>
> ID of the folder to create the list in.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **list\_id** `string` *required*
>
> **success** `boolean` *required*
>
> **list\_url** `string` *required*

> [accordion] Clickup create reminder
>
> **Slug:** `CLICKUP_MCP_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).
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Title for the reminder. Ask the user what they want to be reminded about.
>
> **due\_date** `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.
>
> **description** `string`
>
> Optional description with additional details for the reminder.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> Whether the reminder was created successfully
>
> **reminder\_id** `string` *required*
>
> Unique identifier for the created reminder

> [accordion] Clickup create task
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Task name. Ask the user what they want to name the task.
>
> **tags** `array`
>
> Tag names (must already exist in the space).
>
> **parent** `string`
>
> Parent task ID to create as subtask.
>
> **status** `string`
>
> Override default status. Omit to use list defaults.
>
> **list\_id** `string` *required*
>
> List ID. Use clickup\_get\_list to resolve names.
>
> **due\_date** `string`
>
> Due date in YYYY-MM-DD or YYYY-MM-DD HH:MM format
>
> **priority** `string ("urgent" | "high" | "normal" | "low")`
>
> **assignees** `array`
>
> Array of assignee user IDs. Use clickup\_resolve\_assignees to convert emails, usernames, or "me" to user IDs if needed.
>
> **task\_type** `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.
>
> **start\_date** `string`
>
> Start date in YYYY-MM-DD or YYYY-MM-DD HH:MM format
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **custom\_fields** `array`
>
> Array of custom field values to set on the task. Each object must have an 'id' and 'value' property.
>
> **time\_estimate** `string`
>
> Time estimate in minutes (e.g., '150' for 2h 30m).
>
> **markdown\_description** `string`
>
> Task description in markdown format.
>
> **check\_required\_custom\_fields** `boolean`
>
> Flag to check if all required custom fields are set before saving the task.
>
> #### Output
>
> **success** `boolean` *required*
>
> **task\_id** `string` *required*
>
> **task\_url** `string` *required*
>
> **custom\_id** `string`
>
> Custom task ID (e.g., 'DEV-1234') if the workspace has custom IDs enabled, otherwise null.

> [accordion] Clickup create task comment
>
> **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
>
> **task\_id** `string` *required*
>
> Task ID (supports custom IDs like 'DEV-1234')
>
> **assignee** `number`
>
> User ID to assign the comment to. Use clickup\_resolve\_assignees to convert email, username, or "me" to user ID if needed.
>
> **notify\_all** `boolean`
>
> Whether to notify all assignees. Default is false.
>
> **comment\_text** `string` *required*
>
> Comment content. Supports Markdown formatting.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **comment\_id** `string` *required*

> [accordion] Clickup delete comment
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **comment\_id** `string` *required*
>
> ID of the comment to delete. Use clickup\_get\_task\_comments or clickup\_get\_threaded\_comments to find the comment ID.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **comment\_id** `string` *required*

> [accordion] Clickup delete task
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Task ID to delete (supports custom IDs like 'DEV-1234')
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **task\_id** `string` *required*
>
> **custom\_id** `string`
>
> Custom task ID (e.g., 'DEV-1234') if the workspace has custom IDs enabled, otherwise null.

> [accordion] Clickup download task attachment
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Task ID (supports custom IDs like 'DEV-1234')
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **attachment\_id** `string` *required*
>
> Attachment ID. List a task's attachments with clickup\_get\_task using include: \["attachments"].
>
> #### Output
>
> **url** `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.
>
> **size** `number`
>
> File size in bytes. Absent when the upstream API does not report one (e.g. legacy or link attachments).
>
> **title** `string` *required*
>
> **success** `boolean` *required*
>
> **task\_id** `string` *required*
>
> Resolved task ID.
>
> **mimetype** `string`
>
> MIME type. Absent when the upstream API does not report one (e.g. legacy attachments).
>
> **custom\_id** `string`
>
> Custom task ID (e.g., 'DEV-1234') if the workspace has custom IDs enabled, otherwise null.
>
> **extension** `string`
>
> File extension. Absent when the attachment has none (e.g. extension-less files).
>
> **url\_notice** `string` *required*
>
> Handling instructions for the download URL.
>
> **attachment\_id** `string` *required*

> [accordion] Clickup filter tasks
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **page** `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.
>
> **tags** `array`
>
> Filter by tag names. Multiple tags use OR logic (matches tasks with ANY of the specified tags).
>
> **reverse** `boolean`
>
> Reverse sort order
>
> **list\_ids** `array`
>
> Filter by List IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified lists).
>
> **order\_by** `string ("id" | "created" | "updated" | "due_date")`
>
> Sort results by field
>
> **statuses** `array`
>
> Filter by task status names. Multiple statuses use OR logic (matches tasks with ANY of the specified statuses).
>
> **subtasks** `boolean`
>
> Include subtasks in results (default: true)
>
> **assignees** `array`
>
> Filter by assignee user IDs. Multiple IDs use OR logic. Use clickup\_resolve\_assignees to convert names/emails/"me" first.
>
> **space\_ids** `array`
>
> Filter by Space IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified spaces).
>
> **folder\_ids** `array`
>
> Filter by Folder IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified folders).
>
> **due\_date\_to** `string`
>
> Filter tasks with due date on or before. Format: YYYY-MM-DD
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **due\_date\_from** `string`
>
> Filter tasks with due date on or after. Format: YYYY-MM-DD
>
> **date\_closed\_to** `string`
>
> Filter tasks completed on or before. Format: YYYY-MM-DD
>
> **include\_closed** `boolean`
>
> Include closed tasks in results
>
> **date\_closed\_from** `string`
>
> Filter tasks completed on or after. Format: YYYY-MM-DD
>
> #### Output
>
> **page** `number` *required*
>
> 0-indexed page number that was returned.
>
> **count** `number` *required*
>
> Number of tasks returned on this page.
>
> **tasks** `array` *required*
>
> **message** `string`
>
> Informational message, e.g. guidance to fetch the next page when more results are available.
>
> **has\_more** `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.
>
> **next\_page** `string` *required*
>
> The page value to request next to continue paginating, or null when this is the last page.

> [accordion] Clickup find member by name
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **name\_or\_email** `string` *required*
>
> The name or email of the member to find.
>
> #### Output
>
> **member** `string` *required*
>
> Found member or null

> [accordion] Clickup get bulk tasks time in status
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **task\_ids** `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').
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **tasks** `object` *required*
>
> **task\_count** `number` *required*

> [accordion] Clickup get chat channel messages
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum number of messages to return (1-100).
>
> **cursor** `string`
>
> Cursor for pagination. Use the next\_cursor value from the previous response to fetch the next page of results.
>
> **channel\_id** `string` *required*
>
> ID of the chat channel to get messages from.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **content\_format** `string ("text/plain" | "text/md")`
>
> Response content format.
>
> #### Output
>
> **has\_more** `boolean` *required*
>
> **messages** `array` *required*
>
> **next\_cursor** `string` *required*
>
> **total\_count** `number` *required*

> [accordion] Clickup get chat channels
>
> **Slug:** `CLICKUP_MCP_CLICKUP_GET_CHAT_CHANNELS`
>
> List chat channels in the workspace with pagination support.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum number of channels to return (1-100).
>
> **cursor** `string`
>
> Cursor for pagination. Use the next\_cursor value from the previous response to fetch the next page of results.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **channels** `array` *required*
>
> **has\_more** `boolean` *required*
>
> **next\_cursor** `string` *required*
>
> **total\_count** `number` *required*

> [accordion] Clickup get chat message replies
>
> **Slug:** `CLICKUP_MCP_CLICKUP_GET_CHAT_MESSAGE_REPLIES`
>
> Get threaded replies for a chat message by message\_id. Supports pagination.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum number of replies to return (1-100).
>
> **cursor** `string`
>
> Cursor for pagination. Use the next\_cursor value from the previous response to fetch the next page of results.
>
> **message\_id** `string` *required*
>
> ID of the chat message to get replies from.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **content\_format** `string ("text/plain" | "text/md")`
>
> Response content format.
>
> #### Output
>
> **replies** `array` *required*
>
> **has\_more** `boolean` *required*
>
> **next\_cursor** `string` *required*
>
> **total\_count** `number` *required*

> [accordion] Clickup get current time entry
>
> **Slug:** `CLICKUP_MCP_CLICKUP_GET_CURRENT_TIME_ENTRY`
>
> Get the currently running time entry, if any. No parameters needed.
>
> #### Input Parameters
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **message** `string` *required*
>
> **isTracking** `boolean` *required*
>
> **currentEntry** `string` *required*

> [accordion] Clickup get custom fields
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **list\_id** `string`
>
> List ID. Returns custom fields defined on this list.
>
> **space\_id** `string`
>
> Space ID. Returns custom fields defined on this space.
>
> **folder\_id** `string`
>
> Folder ID. Returns custom fields defined on this folder.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **include\_workspace** `boolean`
>
> If true, returns workspace-level custom fields.
>
> #### Output
>
> **errors** `array`
>
> Error messages for scopes that failed to fetch. Present only when some (but not all) scopes failed.
>
> **list\_fields** `array`
>
> **space\_fields** `array`
>
> **folder\_fields** `array`
>
> **workspace\_fields** `array`

> [accordion] Clickup get document pages
>
> **Slug:** `CLICKUP_MCP_CLICKUP_GET_DOCUMENT_PAGES`
>
> Get the full content of specific pages by page ID. Use list\_document\_pages first to discover available page IDs.
>
> #### Input Parameters
>
> **page\_ids** `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.
>
> **document\_id** `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/.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **content\_format** `string ("text/plain" | "text/md")`
>
> Response content format.
>
> #### Output
>
> **pages** `array` *required*
>
> Document page contents

> [accordion] Clickup get folder
>
> **Slug:** `CLICKUP_MCP_CLICKUP_GET_FOLDER`
>
> Get folder details by folder\_id or folder\_name (+ space info). Use to resolve folder names to IDs.
>
> #### Input Parameters
>
> **space\_id** `string`
>
> ID of the space containing the folder (required with folder\_name).
>
> **folder\_id** `string`
>
> ID of the folder to retrieve.
>
> **space\_name** `string`
>
> Name of the space containing the folder (required with folder\_name).
>
> **folder\_name** `string`
>
> Name of the folder to retrieve. When using this, you must also provide space\_id or space\_name.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **id** `string` *required*
>
> **name** `string` *required*
>
> **space** `object` *required*

> [accordion] Clickup get list
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **list\_id** `string`
>
> ID of the list to retrieve.
>
> **list\_name** `string`
>
> Name of the list to retrieve. The tool will search for a list with this name.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **id** `string` *required*
>
> **url** `string` *required*
>
> **name** `string` *required*
>
> **space** `object` *required*
>
> **content** `string`
>
> **statuses** `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.

> [accordion] Clickup get task
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **include** `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).
>
> **task\_id** `string` *required*
>
> Task ID (supports custom IDs like 'DEV-1234')
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **expand\_statuses** `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.

> [accordion] Clickup get task comments
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **start** `number`
>
> Timestamp (in milliseconds) to start retrieving comments from. Used for pagination.
>
> **task\_id** `string` *required*
>
> Task ID (supports custom IDs like 'DEV-1234')
>
> **start\_id** `string`
>
> Comment ID to start from. Used together with start for pagination.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **count** `number` *required*
>
> Total comment count
>
> **comments** `array` *required*
>
> Array of task comments

> [accordion] Clickup get task time in status
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **task\_id** `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.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **task\_id** `string` *required*
>
> **current\_status** `object` *required*
>
> **status\_history** `array` *required*

> [accordion] Clickup get threaded comments
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **comment\_id** `string` *required*
>
> ID of the parent comment to get threaded replies for.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **count** `number` *required*
>
> **comments** `array` *required*

> [accordion] Clickup get time entries
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **task\_id** `string`
>
> Task ID to scope entries to (supports custom IDs like 'DEV-1234'). Omit to query workspace-wide.
>
> **assignee** `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.
>
> **end\_date** `string`
>
> End date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
>
> **start\_date** `string`
>
> Start date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
>
> **is\_billable** `boolean`
>
> Filter by billable status. Set to true for only billable entries, false for non-billable. Omit to get all entries.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **entries** `array` *required*
>
> **summary** `object` *required*

> [accordion] Clickup get workspace hierarchy
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum number of spaces to return per page (default: 10, max: 50)
>
> **cursor** `string`
>
> Pagination cursor from previous response. Use to fetch next page of spaces
>
> **max\_depth** `string ("0" | "1" | "2")`
>
> Maximum depth of hierarchy to return: 0=spaces only, 1=spaces+folders, 2=spaces+folders+lists (default: 2)
>
> **space\_ids** `array`
>
> Filter to return only specific spaces by ID.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **has\_more** `boolean` *required*
>
> Whether there are more spaces to fetch
>
> **hierarchy** `object` *required*
>
> Workspace hierarchy tree containing paginated spaces
>
> **next\_cursor** `string` *required*
>
> Cursor for next page of spaces, or null if no more pages
>
> **total\_spaces** `number` *required*
>
> Total number of spaces in workspace (after filtering if space\_ids provided)

> [accordion] Clickup get workspace members
>
> **Slug:** `CLICKUP_MCP_CLICKUP_GET_WORKSPACE_MEMBERS`
>
> List all members in the workspace. Most tools resolve assignees automatically — use only when you need the full member list.
>
> #### Input Parameters
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **members** `array` *required*
>
> List of workspace members

> [accordion] Clickup list document pages
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **document\_id** `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/.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **max\_page\_depth** `number`
>
> Maximum depth of pages to retrieve (-1 for unlimited)
>
> #### Output
>
> **pages** `array` *required*
>
> Document page listing

> [accordion] Clickup merge document
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **source\_doc\_id** `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.
>
> **target\_doc\_id** `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
>
> **success** `boolean` *required*
>
> **source\_doc\_id** `string` *required*
>
> **target\_doc\_id** `string` *required*

> [accordion] Clickup merge document page
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **source\_doc\_id** `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.
>
> **target\_doc\_id** `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/.
>
> **source\_page\_id** `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.
>
> **target\_page\_id** `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
>
> **success** `boolean` *required*
>
> **source\_doc\_id** `string`
>
> **target\_doc\_id** `string` *required*
>
> **source\_page\_id** `string` *required*
>
> **target\_page\_id** `string` *required*

> [accordion] Clickup merge tasks
>
> **Slug:** `CLICKUP_MCP_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').
>
> #### Input Parameters
>
> **task\_id** `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').
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **source\_task\_ids** `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
>
> **success** `boolean` *required*
>
> **merged\_task\_id** `string` *required*
>
> The ID of the surviving target task.

> [accordion] Clickup move task
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **list\_id** `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.
>
> **task\_id** `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.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **task\_id** `string` *required*
>
> **custom\_id** `string`
>
> Custom task ID (e.g., 'DEV-1234') if the workspace has custom IDs enabled, otherwise null.
>
> **new\_list\_id** `string` *required*

> [accordion] Clickup remove tag from task
>
> **Slug:** `CLICKUP_MCP_CLICKUP_REMOVE_TAG_FROM_TASK`
>
> Remove tag from task. Only removes tag-task association, tag remains in space.
>
> #### Input Parameters
>
> **task\_id** `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.
>
> **tag\_name** `string` *required*
>
> Name of the tag to remove from the task.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **task\_id** `string` *required*
>
> **tag\_name** `string` *required*
>
> **custom\_id** `string`
>
> Custom task ID (e.g., 'DEV-1234') if the workspace has custom IDs enabled, otherwise null.

> [accordion] Clickup remove task dependency
>
> **Slug:** `CLICKUP_MCP_CLICKUP_REMOVE_TASK_DEPENDENCY`
>
> Remove a dependency between two tasks.
>
> #### Input Parameters
>
> **type** `string ("waiting_on" | "blocking")` *required*
>
> Type of dependency to remove: 'waiting\_on' or 'blocking'.
>
> **task\_id** `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.
>
> **depends\_on** `string` *required*
>
> ID of the task that was in the dependency relationship. Works with both regular task IDs and custom IDs (like 'DEV-1234').
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*

> [accordion] Clickup remove task from list
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **list\_id** `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.
>
> **task\_id** `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.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*

> [accordion] Clickup remove task link
>
> **Slug:** `CLICKUP_MCP_CLICKUP_REMOVE_TASK_LINK`
>
> Remove a link between two tasks.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> ID of the task to remove the link from. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup\_search to find task ID by name if needed.
>
> **links\_to** `string` *required*
>
> ID of the task that was linked to. Works with both regular task IDs and custom IDs (like 'DEV-1234').
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*

> [accordion] Clickup request attachment upload
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Task ID (supports custom IDs like 'DEV-1234')
>
> **file\_name** `string`
>
> Optional file name override (include the extension). Defaults to the local file's own name.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **task\_id** `string` *required*
>
> Resolved task ID the upload is bound to.
>
> **file\_name** `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.
>
> **expires\_at** `string` *required*
>
> ISO 8601 expiry of the upload ticket.
>
> **upload\_url** `string` *required*
>
> URL the file must be POSTed to.
>
> **http\_method** `string` *required*
>
> HTTP method for the upload request (always POST).
>
> **instructions** `string` *required*
>
> How to complete the upload.
>
> **upload\_ticket** `string` *required*
>
> Upload ticket. Send it in the X-Upload-Ticket request header.
>
> **multipart\_field** `string` *required*
>
> multipart/form-data field name for the file (always "attachment").

> [accordion] Clickup resolve assignees
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **assignees** `array` *required*
>
> Array of assignee names, emails, or "me" to resolve. Use "me" to refer to the currently authenticated user.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **userIds** `array` *required*
>
> Array of resolved user IDs. Null entries indicate assignees that could not be resolved.

> [accordion] Clickup search
>
> **Slug:** `CLICKUP_MCP_CLICKUP_SEARCH`
>
> Search across all workspace content (tasks, docs, dashboards, attachments, whiteboards, chats, forms). Best for keyword/text matching across all content types. For filtering tasks by field values (status, priority, tags, dates), use filter\_tasks instead. Supports filtering by assignees, creators, status, location, asset types, and date ranges. Date filters use YYYY-MM-DD or YYYY-MM-DD HH:MM format in your timezone. Results are paginated: the response includes next\_cursor whenever more results exist. When next\_cursor is present you MUST call search again with that value in the cursor field (repeating until next\_cursor is absent) to retrieve every match — a single call is not guaranteed to be complete.
>
> #### Input Parameters
>
> **sort** `array`
>
> Sort criteria for results. Can specify multiple sort fields in priority order
>
> **count** `number`
>
> Maximum number of results to return per page (for pagination)
>
> **cursor** `string`
>
> Pagination cursor from previous response. Use to fetch next page of results
>
> **filters** `object`
>
> Filters to refine search results by various criteria
>
> **keywords** `string`
>
> Search query string. Use specific keywords to find items
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **results** `array` *required*
>
> Array of formatted search results
>
> **overview** `string` *required*
>
> A high-level overview of the search results including count and types found
>
> **next\_cursor** `string` *required*
>
> Pagination cursor for fetching next page, or null if no more results

> [accordion] Clickup search reminders
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **limit** `number`
>
> Maximum number of reminders to return per page (default: 25, max: 100)
>
> **since** `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')
>
> **cursor** `string`
>
> Cursor for pagination. Use the next\_cursor value from the previous response to fetch the next page of results
>
> **is\_overdue** `boolean`
>
> Filter to show only overdue reminders
>
> **is\_completed** `boolean`
>
> Filter to show only completed or incomplete reminders
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **reminder\_type** `string ("ASSIGNED_COMMENT" | "UNANSWERED_MENTION" | "APPROVAL" | "SAVED" | "REMINDER")`
>
> Filter by type of reminder (ASSIGNED\_COMMENT, UNANSWERED\_MENTION, APPROVAL, SAVED, REMINDER)
>
> **due\_date\_status** `string ("TODO" | "LATER" | "DELETED")`
>
> Filter reminders by due date status (TODO, LATER, DELETED)
>
> #### Output
>
> **has\_more** `boolean` *required*
>
> Whether there are more results available
>
> **reminders** `array` *required*
>
> Array of reminder results
>
> **next\_cursor** `string` *required*
>
> Cursor for fetching next page of results, or null if no more results
>
> **total\_count** `number` *required*
>
> Total number of reminders returned in this response

> [accordion] Clickup send chat message
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **type** `string ("message" | "post")`
>
> Type of message to send.
>
> **content** `string` *required*
>
> Message content to send (supports markdown).
>
> **assignee** `string`
>
> User ID to assign the message to. Use clickup\_resolve\_assignees to convert email, username, or "me" to user ID if needed.
>
> **followers** `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.
>
> **channel\_id** `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.
>
> **post\_title** `string`
>
> Title for the post (required if type is 'post').
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **content\_format** `string ("text/md" | "text/plain")`
>
> Format of the message content.
>
> **group\_assignee** `string`
>
> Group ID to assign the message to.
>
> **post\_subtype\_id** `string`
>
> Subtype ID for the post (required if type is 'post').
>
> **parent\_message\_id** `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
>
> **success** `boolean` *required*
>
> **channel\_id** `string` *required*
>
> **message\_id** `string` *required*

> [accordion] Clickup start time tracking
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **tags** `array`
>
> Array of tag names to assign to the time entry.
>
> **task\_id** `string` *required*
>
> Task ID (supports custom IDs like 'DEV-1234')
>
> **billable** `boolean`
>
> Whether this time is billable. Default is workspace setting.
>
> **description** `string`
>
> Description for the time entry. Keep short and simple, or omit for best compatibility.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **taskId** `string` *required*
>
> **message** `string` *required*
>
> **success** `boolean` *required*
>
> **timeEntry** `string` *required*

> [accordion] Clickup stop time tracking
>
> **Slug:** `CLICKUP_MCP_CLICKUP_STOP_TIME_TRACKING`
>
> Stop the currently running time tracker. Supports description and tags. Returns the completed time entry details.
>
> #### Input Parameters
>
> **tags** `array`
>
> Array of tag names to assign to the time entry.
>
> **description** `string`
>
> Description to update or add to the time entry.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **message** `string` *required*
>
> **success** `boolean` *required*
>
> **timeEntry** `string` *required*

> [accordion] Clickup update comment
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **assignee** `number`
>
> User ID to assign the comment to. Use clickup\_resolve\_assignees to convert email, username, or "me" to user ID if needed.
>
> **resolved** `boolean`
>
> Mark the comment as resolved (true) or unresolved (false).
>
> **comment\_id** `string` *required*
>
> ID of the comment to update. Use clickup\_get\_task\_comments or clickup\_get\_threaded\_comments to find the comment ID.
>
> **comment\_text** `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).
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> **comment\_id** `string` *required*

> [accordion] Clickup update document page
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **name** `string`
>
> New name for the page
>
> **content** `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.
>
> **page\_id** `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/.
>
> **sub\_title** `string`
>
> New subtitle for the page
>
> **document\_id** `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/.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **content\_format** `string ("text/md" | "text/plain")`
>
> The format of the page content
>
> **content\_edit\_mode** `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
>
> **page\_id** `string` *required*
>
> **success** `boolean` *required*

> [accordion] Clickup update folder
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **name** `string`
>
> New name for the folder.
>
> **folder\_id** `string` *required*
>
> ID of the folder to update.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **override\_statuses** `boolean`
>
> Whether to override space statuses with folder-specific statuses.
>
> #### Output
>
> **success** `boolean` *required*
>
> **folder\_id** `string` *required*

> [accordion] Clickup update list
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **name** `string`
>
> New name for the list.
>
> **status** `string`
>
> New status for the list.
>
> **content** `string`
>
> New description or content for the list.
>
> **list\_id** `string` *required*
>
> ID of the list to update.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **list\_id** `string` *required*
>
> **success** `boolean` *required*

> [accordion] Clickup update reminder
>
> **Slug:** `CLICKUP_MCP_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.
>
> #### Input Parameters
>
> **title** `string`
>
> New title for the reminder.
>
> **due\_date** `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.
>
> **description** `string`
>
> New description for the reminder.
>
> **reminder\_id** `string` *required*
>
> The unique identifier (KSUID) of the reminder to update.
>
> **is\_completed** `boolean`
>
> Set to true to mark the reminder as completed, false to mark as incomplete.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> #### Output
>
> **success** `boolean` *required*
>
> Whether the reminder was updated successfully
>
> **reminder\_id** `string` *required*
>
> Unique identifier of the updated reminder

> [accordion] Clickup update task
>
> **Slug:** `CLICKUP_MCP_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).
>
> #### Input Parameters
>
> **name** `string`
>
> **status** `string`
>
> New status (must be valid for the task's list).
>
> **task\_id** `string` *required*
>
> Task ID (supports custom IDs like 'DEV-1234')
>
> **due\_date** `string`
>
> YYYY-MM-DD or YYYY-MM-DD HH:MM format. Pass 'none' to clear. Omit to leave unchanged.
>
> **priority** `string ("urgent" | "high" | "normal" | "low" | "none")`
>
> Set priority, or 'none' to clear. Omit to leave unchanged.
>
> **assignees** `array`
>
> Array of assignee user IDs. Use clickup\_resolve\_assignees to convert emails, usernames, or "me" to user IDs if needed.
>
> **task\_type** `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.
>
> **start\_date** `string`
>
> YYYY-MM-DD or YYYY-MM-DD HH:MM format. Pass 'none' to clear. Omit to leave unchanged.
>
> **workspace\_id** `string`
>
> Workspace ID (digits only). Only needed when you have multiple workspaces.
>
> **custom\_fields** `array`
>
> Array of custom field values to set on the task. Each object must have an 'id' and 'value' property.
>
> **time\_estimate** `string`
>
> Time estimate in minutes (e.g., '150' for 2h 30m).
>
> **markdown\_description** `string`
>
> Task description in markdown format.
>
> #### Output
>
> **success** `boolean` *required*
>
> **task\_id** `string` *required*
>
> **task\_url** `string` *required*
>
> **custom\_id** `string`
>
> Custom task ID (e.g., 'DEV-1234') if the workspace has custom IDs enabled, otherwise null.
