ClickUp

By ClickUp

Get New App Alerts

Open in ChatGPT

Open in Claude

Overview

Manage tasks, collaborate with your team, and ship work without leaving ChatGPT or Codex. Post comments with threaded replies and @mentions to keep conversations moving. Send messages in ClickUp Chat. Write and edit Docs and pages. Track time, set custom fields, and search your entire workspace in natural language. Every action syncs to ClickUp in real time, so teammates see your updates instantly.

Tools

clickup_add_tag_to_task

ChatGPT

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

clickup_add_task_dependency

ChatGPT

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.

clickup_add_task_link

ChatGPT

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

clickup_add_task_to_list

ChatGPT

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

clickup_add_time_entry

ChatGPT

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.

clickup_attach_task_file

ChatGPT

Attach file to task. Requires task_id. File sources: 1) base64 + filename, 2) URL (http/https).

clickup_create_comment

ChatGPT

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.

clickup_create_document

ChatGPT

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

clickup_create_document_page

ChatGPT

Create a new page in a ClickUp document.

clickup_create_folder

ChatGPT

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.

clickup_create_list

ChatGPT

Create a list in a ClickUp space efficiently. The system automatically detects workspace ID and resolves space names. Use space_name (preferred for simplicity) or space_id + list name. Name is required. For lists in folders, use clickup_create_list_in_folder. Supports content, due_date, priority, assignee, and status. Note: No need to look up workspace hierarchy or space IDs first - the system handles space name resolution automatically.

clickup_create_list_in_folder

ChatGPT

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_reminder

ChatGPT

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_space_tag

ChatGPT

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_task

ChatGPT

Create task in a ClickUp list. Requires task name and list_id. ALWAYS ask user which list to use - never guess. Use clickup_get_list to resolve list names to IDs. Supports assignees as array of user IDs, emails, usernames, or "me".

clickup_create_task_comment

ChatGPT

Create task comment. Requires task_id and comment_text. Supports notify_all to alert assignees and assignee to assign the comment.

clickup_delete_chat_message

ChatGPT

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_comment

ChatGPT

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_task

ChatGPT

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

clickup_download_document_page_attachment

ChatGPT

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_task_attachment

ChatGPT

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_execute_operator

ChatGPT

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_filter_tasks

ChatGPT

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_find_member_by_name

ChatGPT

Get 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_status

ChatGPT

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_chat_channel_messages

ChatGPT

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

clickup_get_chat_channels

ChatGPT

Get chat channels in a workspace. Allows you to see available chat channels including their members, privacy settings, and creation details. Supports pagination using the cursor parameter.

clickup_get_chat_message_replies

ChatGPT

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.

clickup_get_current_time_entry

ChatGPT

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

clickup_get_custom_fields

ChatGPT

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_document_pages

ChatGPT

Get the content of specific pages from a document.

clickup_get_folder

ChatGPT

Get details of a ClickUp folder by ID or name. Use this tool to lookup a folder ID from a folder name before calling other folder operations. Returns folder details including id, name, and space info. Accepts either folder_id or folder_name + space info.

clickup_get_list

ChatGPT

Get details of a ClickUp list by ID or name. Use this tool to lookup a list ID from a list name before calling other list operations. Returns list details including id, name, content, and space info. Accepts either list_id or list_name.

clickup_get_list_location

ChatGPT

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_operators

ChatGPT

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_schema

ChatGPT

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_task

ChatGPT

Get task details by task_id (works with regular/custom IDs). Set subtasks=true to include all subtask details. Response Size Optimization: - Use detail_level='summary' for lightweight responses when full details aren't needed - Responses exceeding 50,000 tokens automatically switch to summary format to prevent client issues - Summary format includes essential fields: id, name, status, description (truncated), assignees, tags, due_date, url

clickup_get_task_comments

ChatGPT

Get task comments. Use start/start_id params for pagination.

clickup_get_task_time_entries

ChatGPT

Get all time entries for a task with filtering options. Returns all tracked time with user info, descriptions, tags, start/end times, and durations.

clickup_get_task_time_in_status

ChatGPT

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_threaded_comments

ChatGPT

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

clickup_get_time_entries

ChatGPT

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_user

ChatGPT

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_workspace_hierarchy

ChatGPT

Get workspace hierarchy (spaces, folders, lists) from your authenticated workspace with pagination support. Workspace ID is automatically detected from your session. Returns tree structure with names and IDs for navigation. Supports pagination for large workspaces and depth control to fetch only needed levels. Note: Use this ONLY when you need to see the workspace structure - most tools can resolve names automatically without this lookup.

clickup_get_workspace_members

ChatGPT

Get all members (users) in the ClickUp workspace/team from your authenticated workspace. No parameters needed - workspace ID is automatically detected. Note: Most tools automatically resolve assignees by name or email without needing this lookup first. Use this ONLY when you need to see all available members.

clickup_list_document_page_attachments

ChatGPT

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

clickup_list_document_pages

ChatGPT

Get all pages in a document with optional depth control.

clickup_merge_tasks

ChatGPT

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_move_task

ChatGPT

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.

clickup_react_to_chat_message

ChatGPT

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_remove_tag_from_task

ChatGPT

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

clickup_remove_task_dependency

ChatGPT

Remove a dependency between two tasks.

clickup_remove_task_from_list

ChatGPT

Remove a task from an additional list (cannot remove from home list). Requires the Tasks in Multiple Lists ClickApp to be enabled.

clickup_remove_task_link

ChatGPT

Remove a link between two tasks.

clickup_request_attachment_upload

ChatGPT

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.

clickup_resolve_assignees

ChatGPT

Resolve an array of assignee names or emails to ClickUp user IDs. Returns an array of user IDs, or null for any that cannot be resolved. Note: Most task tools automatically resolve assignees - use this only when you need the user IDs separately.

clickup_search

ChatGPT

Universal search across your entire ClickUp workspace. This is a powerful global search tool that finds ANY type of content - tasks, documents, dashboards, attachments, whiteboards, chat messages, and forms. Use this tool when: - You need to find something but don't know exactly where it is or what type it is - You want to search across multiple asset types at once - You're looking for items by keyword, content, or partial name matches - You need to find all items assigned to specific users or created by certain people - You want to search within specific spaces, folders, or lists - You need to filter by creation date or due date ranges - You need results sorted by creation or update time This tool searches EVERYTHING - it looks inside task names, descriptions, document content, chat messages, file names, and more. Results include highlighted matches and full hierarchy (Space > Folder > List) for context. Supports advanced filtering by assignees, creators, status, location, asset types, and date ranges (creation date and due date). Date filters accept dates in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format, and use your user timezone. Returns paginated results with a cursor for fetching additional pages. The results are intelligently formatted for optimal readability, providing a concise overview and structured data for each result. Note: For specific operations on known items (like updating a task you already identified), use the dedicated tools instead.

clickup_search_reminders

ChatGPT

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.

clickup_send_chat_message

ChatGPT

Send a message to a specific chat channel in the workspace. Messages can be either simple messages or posts with additional metadata.

clickup_start_time_tracking

ChatGPT

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.

clickup_stop_time_tracking

ChatGPT

Stop the currently running time tracker. Supports description and tags. Returns the completed time entry details.

clickup_update_chat_message

ChatGPT

Edit a chat message or reply you posted: its text, and for a post its title or type; also resolve it or change its assignee. content replaces the whole message. Read it first with clickup_get_chat_channel_messages or clickup_get_chat_message_replies (content comes back as Markdown), then send back the full Markdown with your change, keeping every file link, image and video link exactly as you read it. A file you leave out is removed and deleted. Only the author can change content. Omit content to change only the title, type, resolved status or assignee.

clickup_update_comment

ChatGPT

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.

clickup_update_document_page

ChatGPT

Update an existing page in a ClickUp document. Supports updating name, subtitle, and content with different edit modes (replace/append/prepend).

clickup_update_folder

ChatGPT

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.

clickup_update_list

ChatGPT

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.

clickup_update_reminder

ChatGPT

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.

clickup_update_task

ChatGPT

Update task properties. Requires task_id and at least one update field. Custom fields supported as array of {id, value}. Supports assignees as array of user IDs, emails, usernames, or "me".

addComment

Claude

clickup_add_tag_to_task

Claude

clickup_add_time_entry

Claude

clickup_attach_task_file

Claude

clickup_create_bulk_tasks

Claude

clickup_create_document

Claude

clickup_create_document_page

Claude

clickup_create_folder

Claude

clickup_create_list

Claude

clickup_create_list_in_folder

Claude

clickup_create_task

Claude

clickup_create_task_comment

Claude

clickup_find_member_by_name

Claude

clickup_get_chat_channels

Claude

clickup_get_current_time_entry

Claude

clickup_get_document_pages

Claude

clickup_get_folder

Claude

clickup_get_list

Claude

clickup_get_task

Claude

clickup_get_task_comments

Claude

clickup_get_task_time_entries

Claude

clickup_get_workspace_hierarchy

Claude

clickup_get_workspace_members

Claude

clickup_get_workspace_tasks

Claude

clickup_list_document_pages

Claude

clickup_remove_tag_from_task

Claude

clickup_resolve_assignees

Claude

clickup_search

Claude

clickup_send_chat_message

Claude

clickup_start_time_tracking

Claude

clickup_stop_time_tracking

Claude

clickup_update_bulk_tasks

Claude

clickup_update_document_page

Claude

clickup_update_folder

Claude

clickup_update_list

Claude

clickup_update_task

Claude

createDocumentOrPage

Claude

createTask

Claude

createTimeEntry

Claude

getListInfo

Claude

getTaskById

Claude

getTimeEntries

Claude

readDocument

Claude

searchSpaces

Claude

searchTasks

Claude

updateDocumentPage

Claude

updateListInfo

Claude

updateTask

Claude

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Links

Documentation Privacy Policy

Similar Apps