ClickUp

Delete a folder. Args: - folderId: The folder ID to delete (required) Returns: Confirmation of deletion.

List all custom fields available in a list. Args: - listId: The list ID (required) - format: Response format Returns: List of custom fields with their IDs, names, types, and configurations.

List all webhooks for a workspace. Args: - teamId: The workspace/team ID (required) - format: Response format Returns: List of webhooks created via the API.

Create a comment on a task. Args: - taskId: The task ID (required) - commentText: The comment content (required) - assignee: User ID to assign the comment to - notifyAll: Notify all assignees and watchers Returns: The created comment ID.

List all lists in a folder. Args: - folderId: The folder ID (required) - archived: Include archived lists - format: Response format Returns: List of lists in the folder.

Update an existing comment. Args: - commentId: The comment ID (required) - commentText: New comment content (required) Returns: Confirmation of update.

Create a new checklist on a task. Args: - taskId: The task ID (required) - name: Checklist name (required) Returns: The created checklist.

Update a checklist. Args: - checklistId: The checklist ID (required) - name: New checklist name - position: New position (0-indexed) Returns: The updated checklist.

Delete a checklist. Args: - checklistId: The checklist ID to delete (required) Returns: Confirmation of deletion.

Create a new item in a checklist. Args: - checklistId: The checklist ID (required) - name: Item name (required) - assignee: User ID to assign the item to Returns: The created checklist item.

Update a checklist item. Args: - checklistId: The checklist ID (required) - checklistItemId: The checklist item ID (required) - name: New item name - assignee: New assignee user ID (null to unassign) - resolved: Mark as resolved/unresolved - parent: Parent item ID for nesting (null to unnest) Returns: The updated checklist item.

Delete a checklist item. Args: - checklistId: The checklist ID (required) - checklistItemId: The checklist item ID to delete (required) Returns: Confirmation of deletion.

List comments on a task. Args: - taskId: The task ID (required) - start: Unix timestamp to start from (for pagination) - startId: Comment ID to start from (for pagination) - format: Response format Returns: List of comments on the task (most recent first, 25 per page).

Delete a comment. Args: - commentId: The comment ID to delete (required) Returns: Confirmation of deletion.

Set a custom field value on a task. Args: - taskId: The task ID (required) - fieldId: The custom field ID (required) - value: The value to set (type depends on field type) - Text: string - Number: number - Dropdown: option name or option ID - Date: Unix timestamp in ms - Checkbox: boolean - Labels: array of label names - Users: array of user IDs - Relationship: array of task IDs Returns: Confirmation of field value set.

Remove a custom field value from a task. Args: - taskId: The task ID (required) - fieldId: The custom field ID (required) Returns: Confirmation of field value removed.

Add a dependency between two tasks. Args: - taskId: The task ID (required) - dependsOn: The task ID that this task depends on (required) - dependencyOf: The task ID that depends on this task (optional, alternative to dependsOn) Note: Use dependsOn when task A depends on task B (A waits for B). Use dependencyOf when task B depends on task A (B waits for A). Returns: Confirmation of dependency added.

Remove a dependency between two tasks. Args: - taskId: The task ID (required) - dependsOn: The task ID to remove as dependency (required) - dependencyOf: The task ID that depended on this task (optional) Returns: Confirmation of dependency removed.

Link two tasks together. Args: - taskId: The task ID (required) - linksTo: The task ID to link to (required) Returns: Confirmation of link added.

Remove a link between two tasks. Args: - taskId: The task ID (required) - linksTo: The linked task ID to remove (required) Returns: Confirmation of link removed.

List members who have explicit access to a task. Note: This does not include people with access through a Team, or access from the List, Folder, or Space where the task exists. Args: - taskId: The task ID (required) - format: Response format Returns: List of workspace members with explicit task access.

List members of a list. Args: - listId: The list ID (required) - format: Response format Returns: List of workspace members with list access.

List all goals in a workspace. Args: - teamId: The workspace/team ID (required) - includeCompleted: Include completed goals - format: Response format Returns: List of goals in the workspace.

Get details of a specific goal. Args: - goalId: The goal ID (required) - format: Response format Returns: Goal details including key results and progress.

Create a new goal. Args: - teamId: The workspace/team ID (required) - name: Goal name (required) - dueDate: Due date (Unix ms) - description: Goal description - multipleOwners: Allow multiple owners - owners: Array of owner user IDs - color: Goal color Returns: The created goal.

Update an existing goal. Args: - goalId: The goal ID (required) - name: New goal name - dueDate: New due date (Unix ms) - description: New description - addOwners: User IDs to add as owners - removeOwners: User IDs to remove as owners - color: New goal color Returns: The updated goal.

Delete a goal. Args: - goalId: The goal ID to delete (required) Returns: Confirmation of deletion.

List all folderless lists in a space. Args: - spaceId: The space ID (required) - archived: Include archived lists - format: Response format Returns: List of folderless lists in the space.

Create a key result for a goal. Args: - goalId: The goal ID (required) - name: Key result name (required) - type: Key result type (number, currency, boolean, percentage, automatic) - stepsStart: Starting value for numeric types - stepsEnd: Target value for numeric types - unit: Unit of measurement - owners: Array of owner user IDs - taskIds: Array of task IDs to track (for automatic type) - listIds: Array of list IDs to track (for automatic type) Returns: The created key result.

Update a key result. Args: - keyResultId: The key result ID (required) - name: New name - stepsCurrent: Current progress value - note: Progress note Returns: The updated key result.

Delete a key result. Args: - keyResultId: The key result ID to delete (required) Returns: Confirmation of deletion.

List all workspaces/teams the authenticated user has access to. Returns: List of workspaces with their IDs, names, and member counts.

List all spaces in a workspace. Args: - teamId: The workspace/team ID (required) - archived: Include archived spaces - format: Response format Returns: List of spaces in the workspace.

Get details of a specific space. Args: - spaceId: The space ID (required) - format: Response format Returns: Space details including features and statuses.

Create a new space in a workspace. Args: - teamId: The workspace/team ID (required) - name: Space name (required) - multipleAssignees: Allow multiple assignees - features: Feature settings object Returns: The created space.

Update an existing space. Args: - spaceId: The space ID (required) - name: New space name - color: New color - private: Make space private/public - adminCanManage: Allow admins to manage Returns: The updated space.

Delete a space. Args: - spaceId: The space ID to delete (required) Returns: Confirmation of deletion.

List all folders in a space. Args: - spaceId: The space ID (required) - archived: Include archived folders - format: Response format Returns: List of folders in the space.

Get details of a specific folder. Args: - folderId: The folder ID (required) - format: Response format Returns: Folder details including lists.

Create a new folder in a space. Args: - spaceId: The space ID (required) - name: Folder name (required) Returns: The created folder.

Update an existing folder. Args: - folderId: The folder ID (required) - name: New folder name (required) Returns: The updated folder.

Get details of a specific list. Args: - listId: The list ID (required) - format: Response format Returns: List details including task count and status.

Create a new list in a folder. Args: - folderId: The folder ID (required) - name: List name (required) - content: List description - dueDate: Due date (Unix ms) - priority: Priority level - assignee: Default assignee ID - status: Default status Returns: The created list.

Create a new folderless list in a space. Args: - spaceId: The space ID (required) - name: List name (required) - content: List description - dueDate: Due date (Unix ms) - priority: Priority level - assignee: Default assignee ID - status: Default status Returns: The created list.

Update an existing list. Args: - listId: The list ID (required) - name: New list name - content: New description - dueDate: New due date (Unix ms) - priority: New priority level - assignee: New default assignee ID Returns: The updated list.

Delete a list. Args: - listId: The list ID to delete (required) Returns: Confirmation of deletion.

List all tags in a space. Args: - spaceId: The space ID (required) - format: Response format Returns: List of tags available in the space.

Create a new tag in a space. Args: - spaceId: The space ID (required) - name: Tag name (required) - tagFg: Foreground color (hex) - tagBg: Background color (hex) Returns: The created tag.

Update an existing tag in a space. Args: - spaceId: The space ID (required) - tagName: Current tag name (required) - newName: New tag name (required) - tagFg: New foreground color (hex) - tagBg: New background color (hex) Returns: The updated tag.

Delete a tag from a space. Args: - spaceId: The space ID (required) - tagName: The tag name to delete (required) Returns: Confirmation of deletion.

Add a tag to a task. Args: - taskId: The task ID (required) - tagName: The tag name to add (required) Returns: Confirmation of tag added.

Remove a tag from a task. Args: - taskId: The task ID (required) - tagName: The tag name to remove (required) Returns: Confirmation of tag removed.

List tasks in a ClickUp list with optional filters. Args: - listId: The list ID to get tasks from (required) - archived: Include archived tasks - page: Page number for pagination (0-indexed) - subtasks: Include subtasks - statuses: Filter by status names - assignees: Filter by assignee IDs - tags: Filter by tag names - includeClosed: Include closed tasks - dueDateGt: Filter tasks with due date after (Unix ms) - dueDateLt: Filter tasks with due date before (Unix ms) - format: Response format ('json' or 'markdown') Returns: List of tasks matching the criteria (max 100 per page).

Search for tasks across a workspace with filters. Args: - teamId: The workspace/team ID (required) - page: Page number for pagination (0-indexed) - subtasks: Include subtasks - statuses: Filter by status names - assignees: Filter by assignee IDs - tags: Filter by tag names - includeClosed: Include closed tasks - spaceIds: Filter by space IDs - folderIds: Filter by folder IDs - listIds: Filter by list IDs - dueDateGt: Filter tasks with due date after (Unix ms) - dueDateLt: Filter tasks with due date before (Unix ms) - format: Response format Returns: List of tasks matching the criteria (max 100 per page).

Get details of a specific task. Args: - taskId: The task ID (required) - includeSubtasks: Include subtasks in response - includeMarkdownDescription: Include markdown description - format: Response format Returns: Full task details including status, assignees, dates, custom fields, etc.

Create a new task in a ClickUp list. Args: - listId: The list ID to create the task in (required) - name: Task name (required) - description: Task description - markdownDescription: Task description in markdown format - assignees: Array of user IDs to assign - tags: Array of tag names - status: Status name - priority: Priority level (1=Urgent, 2=High, 3=Normal, 4=Low) - dueDate: Due date (Unix ms) - startDate: Start date (Unix ms) - timeEstimate: Time estimate in milliseconds - parent: Parent task ID for subtask - notifyAll: Notify all assignees Returns: The created task.

Update an existing task. Args: - taskId: The task ID to update (required) - name: New task name - description: New description - status: New status name - priority: New priority (1=Urgent, 2=High, 3=Normal, 4=Low, null to clear) - dueDate: New due date (Unix ms, null to clear) - startDate: New start date (Unix ms, null to clear) - timeEstimate: New time estimate (ms, null to clear) - addAssignees: User IDs to add as assignees - removeAssignees: User IDs to remove as assignees - archived: Archive/unarchive the task Returns: The updated task.

Delete a task. Args: - taskId: The task ID to delete (required) Returns: Confirmation of deletion.

List time entries for a workspace. Args: - teamId: The workspace/team ID (required) - startDate: Start of date range (Unix ms) - endDate: End of date range (Unix ms) - assignee: Filter by user ID - spaceId: Filter by space ID - folderId: Filter by folder ID - listId: Filter by list ID - taskId: Filter by task ID - includeTaskTags: Include task tags in response - includeLocationNames: Include location names - format: Response format Returns: List of time entries (defaults to last 30 days for authenticated user).

Get a specific time entry. Args: - teamId: The workspace/team ID (required) - timerId: The time entry ID (required) - format: Response format Returns: Time entry details.

Create a new time entry. Args: - teamId: The workspace/team ID (required) - start: Start time (Unix ms, required) - duration: Duration in milliseconds (required) - end: End time (Unix ms) - taskId: Task ID to log time against - description: Time entry description - billable: Mark as billable - tags: Array of tag names Returns: The created time entry.

Delete a time entry. Args: - teamId: The workspace/team ID (required) - timerId: The time entry ID to delete (required) Returns: Confirmation of deletion.

Start a time tracking timer. Args: - teamId: The workspace/team ID (required) - taskId: Task ID to track time against - description: Timer description - billable: Mark as billable - tags: Array of tag names Returns: The started time entry.

Stop the currently running time tracking timer. Args: - teamId: The workspace/team ID (required) Returns: The stopped time entry with duration.

Get the currently running time tracking timer. Args: - teamId: The workspace/team ID (required) - format: Response format Returns: The running time entry or null if no timer is running.

List all views in a space. Args: - spaceId: The space ID (required) - format: Response format Returns: List of task and page views available in the space.

List all views in a folder. Args: - folderId: The folder ID (required) - format: Response format Returns: List of views available in the folder.

List all views in a list. Args: - listId: The list ID (required) - format: Response format Returns: List of views available in the list.

Get details of a specific view. Args: - viewId: The view ID (required) - format: Response format Returns: View details including settings and filters.

Get tasks from a specific view. Args: - viewId: The view ID (required) - page: Page number for pagination (0-indexed) - format: Response format Returns: List of tasks as displayed in the view.

Create a new webhook. Args: - teamId: The workspace/team ID (required) - endpoint: The URL to receive webhook events (required) - events: Array of event types to subscribe to (required) - spaceId: Filter to specific space - folderId: Filter to specific folder - listId: Filter to specific list - taskId: Filter to specific task Available events: Task events: taskCreated, taskUpdated, taskDeleted, taskPriorityUpdated, taskStatusUpdated, taskAssigneeUpdated, taskDueDateUpdated, taskTagUpdated, taskMoved, taskCommentPosted, taskCommentUpdated, taskTimeEstimateUpdated, taskTimeTrackedUpdated List events: listCreated, listUpdated, listDeleted Folder events: folderCreated, folderUpdated, folderDeleted Space events: spaceCreated, spaceUpdated, spaceDeleted Goal events: goalCreated, goalUpdated, goalDeleted, keyResultCreated, keyResultUpdated, keyResultDeleted Returns: The created webhook with ID and secret.

Update an existing webhook. Args: - webhookId: The webhook ID (required) - endpoint: New endpoint URL - events: New array of event types - status: Webhook status ('active' or 'inactive') Returns: The updated webhook.

Delete a webhook. Args: - webhookId: The webhook ID to delete (required) Returns: Confirmation of deletion.