clickup_search
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_get_workspace_hierarchy
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_create_task
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". Supports task_type to specify the task type by name (e.g., 'Bug', 'Feature').
clickup_get_task
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_filter_tasks
Retrieve tasks with combined filters. Supports filtering by tags, lists, folders, spaces, statuses, assignees, due date range, and completion date range. Within each filter type, multiple values use OR logic (e.g., tags: ["bug", "feature"] returns tasks with either tag). Across filter types, AND logic applies (e.g., tags: ["bug"] + list_ids: ["123"] returns only "bug"-tagged tasks in list 123). Use this tool when you need to find tasks by tag (e.g., "bug"), list multiple tasks matching criteria, or combine multiple filters. Use date_done_from/date_done_to with include_closed to find completed tasks in a date range. For single task by ID, use clickup_get_task instead. Assignees must be numeric user IDs — use clickup_resolve_assignees to convert names/emails/"me" first.
clickup_update_task
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". Supports task_type to change the task type by name (e.g., 'Bug', 'Feature'), or null to reset to default.
clickup_delete_task
Delete a task from your Workspace by task_id. Works with regular and custom IDs (e.g. 'DEV-1234'). IMPORTANT: before running this tool, ALWAYS confirm with the user the correct task_id to delete.
clickup_move_task
Move a task to a new home list. The task is removed from its current home list and placed in the destination list. Requires task_id and list_id. Works with regular and custom task IDs (e.g. 'DEV-1234'). Use clickup_get_list to resolve list names to IDs.
clickup_add_task_to_list
Add a task to an additional list without removing it from its current home list. Requires the Tasks in Multiple Lists ClickApp to be enabled. Requires task_id and list_id. Use clickup_get_list to resolve list names to IDs.
clickup_remove_task_from_list
Remove a task from an additional list. The task remains in its home list and any other lists it belongs to. Cannot remove a task from its home list. Requires the Tasks in Multiple Lists ClickApp to be enabled. Requires task_id and list_id.
clickup_get_task_comments
Get task comments. Each comment includes reply_count indicating the number of threaded replies. Use clickup_get_threaded_comments to fetch replies for comments with reply_count > 0. Use start/start_id params for pagination.
clickup_create_task_comment
Create task comment. Requires task_id and comment_text. Supports notify_all to alert assignees and assignee to assign the comment.
clickup_get_threaded_comments
Get threaded replies for a comment. Use clickup_get_task_comments first to find comments with reply_count > 0, then use this tool with the comment_id to fetch the thread replies.
clickup_attach_task_file
Attach file to task. Requires task_id. File sources: 1) base64 + filename, 2) URL (http/https).
clickup_get_task_time_entries
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_start_time_tracking
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
Stop the currently running time tracker. Supports description and tags. Returns the completed time entry details.
clickup_add_time_entry
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_get_current_time_entry
Get the currently running time entry, if any. No parameters needed.
clickup_get_time_entries
Get time entries across all tasks within a date range for reporting purposes. Unlike get_task_time_entries which requires a task_id, this tool queries the entire workspace and is ideal for generating time tracking reports (e.g., 'how much time was tracked last month', 'billable hours this week').
clickup_get_task_time_in_status
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_bulk_tasks_time_in_status
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_create_list
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
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_get_list
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_update_list
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_create_folder
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_get_folder
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_update_folder
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_add_tag_to_task
Add existing tag to task. Tag must exist in space. Note: Will fail if tag doesn't exist.
clickup_remove_tag_from_task
Remove tag from task. Only removes tag-task association, tag remains in space.
clickup_add_task_dependency
Set a dependency between two tasks. Use 'waiting_on' when task_id cannot start until depends_on is done, or 'blocking' when task_id is blocking depends_on.
clickup_remove_task_dependency
Remove a dependency between two tasks.
clickup_add_task_link
Link two tasks together. Creates a bidirectional relationship between the tasks.
clickup_remove_task_link
Remove a link between two tasks.
clickup_get_workspace_members
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_find_member_by_name
Get a member in the ClickUp workspace by name or email. Returns the member object if found, or null if not found.
clickup_resolve_assignees
Resolve an array of assignee names, emails, or "me" to ClickUp user IDs. Use "me" to get the currently authenticated user's ID. 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 (e.g., for search filters).
clickup_get_chat_channels
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_send_chat_message
Send a message to a specific chat channel in the workspace. Messages can be either simple messages or posts with additional metadata.
clickup_get_chat_channel_messages
Get messages for a chat channel. Messages where has_replies=true have threaded replies fetchable via clickup_get_chat_message_replies. If you don't have the channel_id, use clickup_get_chat_channels first. Supports pagination.
clickup_get_chat_message_replies
Get threaded replies for a chat message. Only messages where has_replies=true have replies. If you don't have the message_id, use clickup_get_chat_channel_messages first. Supports pagination.
clickup_create_reminder
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_search_reminders
Search and list reminders in your ClickUp workspace. Returns reminders for the authenticated user with various filtering options.
Use this tool when you need to:
- Find all your upcoming or overdue reminders
- Check reminder status and due dates
- Filter reminders by type (ASSIGNED_COMMENT, UNANSWERED_MENTION, APPROVAL, SAVED, REMINDER)
- Filter reminders by status (TODO, LATER, DELETED)
- Filter reminders by completion status
- List reminders updated after a specific date
The since filter accepts dates in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format, and uses your user timezone. Supports pagination using the cursor parameter for large result sets.
clickup_update_reminder
Update an existing reminder in your ClickUp workspace. Requires the reminder_id. All other fields are optional - only provide the fields you want to update.
Use this tool to:
- Change the title or description of a reminder
- Update the due date (in YYYY-MM-DD or YYYY-MM-DD HH:MM format, uses your timezone)
- Mark a reminder as completed or incomplete
clickup_get_custom_fields
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_create_document
Create a document in a ClickUp space, folder, or list. Requires name, parent info, visibility and create_page flag.
clickup_list_document_pages
Get all pages in a document with optional depth control.
clickup_get_document_pages
Get the content of specific pages from a document.
clickup_create_document_page
Create a new page in a ClickUp document.
clickup_update_document_page
Update an existing page in a ClickUp document. WARNING: When content is provided, it fully REPLACES the existing page content. To preserve existing content, first read the page, then include the original content along with your changes.