ClickUp MCP for AI agents
Agents read ClickUp MCP at once. Changes and sends are held for a person's approval by default.
About ClickUp MCP
ClickUp MCP lets agents search and manage tasks, lists, folders, docs, comments, chat, and time-tracking workflows in a ClickUp workspace.
What an agent can do in ClickUp MCP
Every ClickUp MCP action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in ClickUp MCP without asking first. 24 actions.
- 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.
- 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-li
- 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
- 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.
- 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 Sta
- 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.
- Clickup get chat channelsList chat channels in the workspace with pagination support.
- Clickup get chat message repliesGet threaded replies for a chat message by message_id. Supports pagination.
- Clickup get current time entryGet the currently running time entry, if any. No parameters needed.
- 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
- Clickup get document pagesGet the full content of specific pages by page ID. Use list_document_pages first to discover available page IDs.
- Clickup get folderGet folder details by folder_id or folder_name (+ space info). Use to resolve folder names to IDs.
Show all 24
- 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.
- 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_co
- 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.
- 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 b
- 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.
- 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, on
- 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.
- Clickup get workspace membersList all members in the workspace. Most tools resolve assignees automatically — use only when you need the full member list.
- 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.
- 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.
- 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 (sta
- 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
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 34 actions.
- Clickup add tag to taskAdd existing tag to task. Tag must exist in space. Note: Will fail if tag doesn't exist.
- 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 a
- Clickup add task linkLink two tasks together. Creates a bidirectional association with no ordering or blocking. For blocking/dependency relationships, use add_task_dependency instead.
- 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. Su
- 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.
- 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 threa
- Clickup create documentCreate a document in a ClickUp space, folder, or list. Requires name, parent info, visibility and create_page flag.
- Clickup create document pageCreate a new page in a ClickUp document.
- 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 crea
- 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.
- 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.
- 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).
Show all 34
- 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.
- 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.
- 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.
- Clickup delete taskDelete a task by task_id (supports custom IDs like 'DEV-1234'). Always confirm the task_id with the user before deleting.
- 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. `t
- 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 i
- 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
- 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.
- Clickup remove tag from taskRemove tag from task. Only removes tag-task association, tag remains in space.
- Clickup remove task dependencyRemove a dependency between two tasks.
- 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.
- Clickup remove task linkRemove a link between two tasks.
- 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
- 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.
- 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.
- Clickup stop time trackingStop the currently running time tracker. Supports description and tags. Returns the completed time entry details.
- 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
- 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
- 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 fr
- 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.
- 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.
- 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' t
Changes wait in Needs you
Changes and sends in ClickUp MCP are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
ClickUp MCP questions
Can an agent change data in ClickUp MCP on its own?
Not by default. Changes and sends in ClickUp MCP are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in ClickUp MCP?
This connector lists 24 read actions. Reads run at once, without waiting for approval.
How does ClickUp MCP connect?
It connects with dcr oauth. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.