ClickUp

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.

clickup_create_list

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.

clickup_create_list_in_folder

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

clickup_create_reminder

Create a tag in a space so it can be added to tasks with clickup_add_tag_to_task. Tags belong to a space and are shared by every task in it. If a tag with the same name already exists, nothing is changed and the existing tag is returned with created=false. A previously deleted tag with the same name is restored with its old colors; the response carries the stored colors.

clickup_create_space_tag

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.

clickup_create_task

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

Delete a chat message, thread reply or post by message_id. This cannot be undone. Deleting a top-level message also deletes every reply in its thread; to remove only one reply, pass that reply's id. Confirm with the user before deleting a message that has replies or that someone else wrote. Find ids via clickup_get_chat_channel_messages or clickup_get_chat_message_replies. For task comments use clickup_delete_comment.

clickup_delete_chat_message

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.

clickup_delete_comment

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

clickup_delete_task

Download a ClickUp doc page attachment (get attachment IDs from clickup_list_document_page_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.

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

clickup_download_task_attachment

Run one enabled Unified API operator (a `<model>.<operator>` pair) as the authenticated user, in the session workspace. The operator catalog is how this server exposes ClickUp operations beyond the dedicated clickup_* tools, and it grows over time: reach for it when no dedicated tool fits the request or when a request spans many objects (for example several tasks to change, create or read). Call clickup_get_operators first; it lists the enabled operators with each one's parameters and request-body schema, and only enabled operators are callable. Prefer a dedicated clickup_* tool when one covers the whole request in a single call. workspace_id is taken from the session and cannot be overridden. Operators that return full objects (creates and updates included) can produce very large results: pass query with the request to project only the fields you need. Errors carry the upstream status, operationId and response body. Do not retry a call that timed out: the operation may have completed.

clickup_execute_operator

Retrieve tasks with combined filters (tags, lists, folders, spaces, statuses, assignees, due date range, completion date range, custom field values). Multiple values within a filter use OR logic; across filters, AND logic applies (custom_fields entries also AND together). Best for filtering tasks by structured field values. For text/keyword search across all workspace content, use search instead. Custom field filters need field IDs — discover them with clickup_get_custom_fields. 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.

clickup_filter_tasks

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

clickup_find_member_by_name

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.

clickup_get_bulk_tasks_time_in_status

Get messages for a chat channel. Messages with has_replies=true have threads fetchable via clickup_get_chat_message_replies. Supports pagination. Channel URLs look like /<ws>/v/cn/<channel_id> or /<ws>/chat/r/<channel_id>. Attachments come back as Markdown links. On workspaces with private attachments the links are short-lived (about 5 minutes) and single-use: download each once, immediately, and re-read the message for a fresh link. Set include_reactions to true to see who reacted (limit must be 25 or fewer).

clickup_get_chat_channel_messages

List chat channels in the workspace with pagination support.

clickup_get_chat_channels

Get threaded replies for a chat message by message_id. Supports pagination. Chat thread URLs (/<ws>/v/cn/<channel_id>/t/<id> or /<ws>/chat/r/<channel_id>/t/<id>) end in a chat message id — pass it here, not to clickup_get_task. That id is usually the thread root but can be a reply inside the thread; if no replies come back, find the thread root via clickup_get_chat_channel_messages on the channel. Attachments come back as Markdown links. On workspaces with private attachments the links are short-lived (about 5 minutes) and single-use: download each once, immediately, and re-read the message for a fresh link. Set include_reactions to true to see who reacted (limit must be 25 or fewer).

clickup_get_chat_message_replies

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

clickup_get_current_time_entry

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.

clickup_get_custom_fields

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

clickup_get_document_pages

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

clickup_get_folder

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.

clickup_get_list

Get the names and links of the space and folders that contain a list, for the ClickUp task card view. To find a list, use clickup_get_list or clickup_get_workspace_hierarchy instead.

clickup_get_list_location

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. URL disambiguation: a bare /t/<id> or /t/<workspace>/<id> ClickUp URL is a task, but in chat thread URLs (/v/cn/<channel_id>/t/<id> or /chat/r/<channel_id>/t/<id>) the trailing id is a chat MESSAGE id — use clickup_get_chat_message_replies for those.

clickup_get_task

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.

clickup_get_task_comments

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.

clickup_get_task_time_in_status

Get threaded replies for a comment by comment_id. Use clickup_get_task_comments first to find comments with reply_count > 0.

clickup_get_threaded_comments

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.

clickup_get_time_entries

Returns the entity-relationship schema (Markdown with a Mermaid ER diagram) for the models behind the enabled Unified API operators. Optional background before a clickup_execute_operator call; not needed for the dedicated clickup_* tools.

clickup_get_schema

Get the authenticated user: id, username and email, plus their ClickUp account timezone, week-start day, and the current date and time in that timezone. Call this before computing any relative date ("today", "tomorrow", "this week", "overdue") for other tools: your own clock or an assumed timezone can silently land on the wrong day for this user. Date parameters on other tools accept concrete dates only; resolve relative expressions against current_time. Assignee fields accept "me" directly, so no lookup is needed to act as the user.

clickup_get_user

Get workspace hierarchy (spaces, folders, lists) with pagination and depth control. Use to browse the structure or to find a space, folder, or list whose name is unknown. When the name is known, clickup_get_list and clickup_get_folder resolve it to an id directly; task tools take ids only.

clickup_get_workspace_hierarchy

List all members in the workspace. Most tools resolve assignees automatically — use only when you need the full member list.

clickup_get_workspace_members

List metadata for files attached to a ClickUp doc page (images and files embedded in the page content).

clickup_list_document_page_attachments

List page names and structure of a document (no content). Use get_document_pages to fetch full page content by page ID.

clickup_list_document_pages

Lists the Unified API operators enabled on this server (`<model>.<operator>` pairs) with each one's HTTP route, parameters and request/response body schema, as Markdown. The catalog is how this server exposes ClickUp operations beyond the dedicated clickup_* tools, and it grows over time: call this whenever no dedicated tool fits the request, whenever a request spans many objects, and always before clickup_execute_operator to build a correct call. It is also the only reliable answer to what this server can do: answer any question about its capabilities by calling it, never from tool names or descriptions. Operators that are not enabled are never shown.

clickup_get_operators

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

clickup_merge_tasks

Move a root task to a new home list. Requires task_id (regular or custom ID) and a numeric list_id — resolve list names with clickup_get_list (list_name) first. Subtasks cannot be moved; move the parent instead. The task's current status must exist in the destination list; otherwise set a matching status with clickup_update_task before moving.

clickup_move_task

Add or remove the authenticated user's emoji reaction on a chat message or reply. Reactions are primary lowercase emoji shortcodes such as "+1", "heart", "eyes", "white_check_mark", "tada", "rocket" (wrapping colons are optional); aliases like "thumbsup" or "thumbs_up" are rejected, and custom workspace emoji are addressed by name. Adding a reaction that is already present, or removing one that is absent, fails with a "nothing changed" error. Only the caller's own reactions are affected.

clickup_react_to_chat_message

Remove tag from task. Only removes tag-task association, tag remains in space.

clickup_remove_tag_from_task