- Category: model context protocol
- Auth: DCR_OAUTH
- Composio-managed OAuth available? No
- Tools: 58
- Triggers: 0
- Slug:
CLICKUP_MCP - Version: 20261018_00
Tools
Clickup add tag to task
Clickup add tag to task
Clickup add task dependency
Clickup add task dependency
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
Output
Clickup add task link
Clickup add task link
Clickup add task to list
Clickup add task to list
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
Output
Clickup add time entry
Clickup add time entry
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
Output
Clickup attach task file
Clickup attach task file
Clickup create comment
Clickup create comment
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
Output
Clickup create document
Clickup create document
Clickup create document page
Clickup create document page
Clickup create folder
Clickup create folder
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
Output
Clickup create list
Clickup create list
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
Output
Clickup create list in folder
Clickup create list in folder
Clickup create reminder
Clickup create reminder
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
Output
Clickup create task
Clickup create task
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
Output
Clickup create task comment
Clickup create task comment
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
Output
Clickup delete comment
Clickup delete comment
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
Output
Clickup delete task
Clickup delete task
Clickup download task attachment
Clickup download task attachment
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
Output
Clickup filter tasks
Clickup filter tasks
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
Output
Clickup find member by name
Clickup find member by name
Clickup get bulk tasks time in status
Clickup get bulk tasks time in status
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
Output
Clickup get chat channel messages
Clickup get chat channel messages
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
Output
Clickup get chat channels
Clickup get chat channels
Clickup get chat message replies
Clickup get chat message replies
Clickup get current time entry
Clickup get current time entry
Clickup get custom fields
Clickup get custom fields
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
Output
Clickup get document pages
Clickup get document pages
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
Output
Clickup get folder
Clickup get folder
Clickup get list
Clickup get list
Clickup get task
Clickup get task
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
Clickup get task comments
Clickup get task comments
Clickup get task time in status
Clickup get task time in status
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
Output
Clickup get threaded comments
Clickup get threaded comments
Clickup get time entries
Clickup get time entries
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
Output
Clickup get workspace hierarchy
Clickup get workspace hierarchy
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
Output
Clickup get workspace members
Clickup get workspace members
Clickup list document pages
Clickup list document pages
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
Output
Clickup merge document
Clickup merge document
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
Output
Clickup merge document page
Clickup merge document page
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
Output
Clickup merge tasks
Clickup merge tasks
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
Output
Clickup move task
Clickup move task
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
Output
Clickup remove tag from task
Clickup remove tag from task
Clickup remove task dependency
Clickup remove task dependency
CLICKUP_MCP_CLICKUP_REMOVE_TASK_DEPENDENCYRemove a dependency between two tasks.Input Parameters
Output
Clickup remove task from list
Clickup remove task from list
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
Output
Clickup remove task link
Clickup remove task link
CLICKUP_MCP_CLICKUP_REMOVE_TASK_LINKRemove a link between two tasks.Input Parameters
Output
Clickup request attachment upload
Clickup request attachment upload
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
Output
Clickup resolve assignees
Clickup resolve assignees
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
Output
Clickup search
Clickup search
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
Output
Clickup search reminders
Clickup search reminders
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
Output
Clickup send chat message
Clickup send chat message
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
Output
Clickup start time tracking
Clickup start time tracking
Clickup stop time tracking
Clickup stop time tracking
Clickup update comment
Clickup update comment
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
Output
Clickup update document page
Clickup update document page
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
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
Clickup update folder
Clickup update folder
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
Output
Clickup update list
Clickup update list
Clickup update reminder
Clickup update reminder
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
Output
Clickup update task
Clickup update task
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).