ClickUp MCP

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

Untrusted display-only summary

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.

Untrusted display-only summary

Link two tasks together. Creates a bidirectional association with no ordering or blocking. For blocking/dependency relationships, use add_task_dependency instead.

Untrusted display-only summary

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

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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

Untrusted display-only summary

Create a new page in a ClickUp document.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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.

Untrusted display-only summary

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

Untrusted display-only summary

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.

Untrusted display-only summary

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

Untrusted display-only summary

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.

Untrusted display-only summary

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

Untrusted display-only summary

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 immediatel…

Untrusted display-only summary

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, us…

Untrusted display-only summary

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

Untrusted display-only summary

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.

Untrusted display-only summary

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

Untrusted display-only summary

List chat channels in the workspace with pagination support.

Untrusted display-only summary

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

Untrusted display-only summary

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

Untrusted display-only summary

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.

Untrusted display-only summary

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

Untrusted display-only summary

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

Untrusted display-only summary

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.

Untrusted display-only summary

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_st…

Untrusted display-only summary