ClickUp AI Integration

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.

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.

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

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

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.