ClickUp

ClickUp MCP Server for Cloudflare Workers

Available Tools

73 tools available in the ClickUp MCP server. Each tool can be called by AI assistants to perform specific actions.

clickup_delete_folder

Delete a folder.

Args:

folderId: The folder ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "folderId"
  ],
  "properties": {
    "folderId": {
      "type": "string",
      "description": "Folder ID to delete"
    }
  }
}

clickup_list_custom_fields

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.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

clickup_list_webhooks

List all webhooks for a workspace.

Args:

teamId: The workspace/team ID (required)
format: Response format

Returns: List of webhooks created via the API.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    }
  }
}

clickup_create_comment

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.

{
  "type": "object",
  "required": [
    "taskId",
    "commentText"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "assignee": {
      "type": "number",
      "description": "User ID to assign comment to"
    },
    "notifyAll": {
      "type": "boolean",
      "default": true,
      "description": "Notify all"
    },
    "commentText": {
      "type": "string",
      "description": "Comment content"
    }
  }
}

clickup_list_lists

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.

{
  "type": "object",
  "required": [
    "folderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "archived": {
      "type": "boolean",
      "description": "Include archived lists"
    },
    "folderId": {
      "type": "string",
      "description": "Folder ID"
    }
  }
}

clickup_update_comment

Update an existing comment.

Args:

commentId: The comment ID (required)
commentText: New comment content (required)

Returns: Confirmation of update.

{
  "type": "object",
  "required": [
    "commentId",
    "commentText"
  ],
  "properties": {
    "commentId": {
      "type": "string",
      "description": "Comment ID"
    },
    "commentText": {
      "type": "string",
      "description": "New comment content"
    }
  }
}

clickup_create_checklist

Create a new checklist on a task.

Args:

taskId: The task ID (required)
name: Checklist name (required)

Returns: The created checklist.

{
  "type": "object",
  "required": [
    "taskId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Checklist name"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

clickup_update_checklist

Update a checklist.

Args:

checklistId: The checklist ID (required)
name: New checklist name
position: New position (0-indexed)

Returns: The updated checklist.

{
  "type": "object",
  "required": [
    "checklistId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "position": {
      "type": "integer",
      "minimum": 0,
      "description": "New position"
    },
    "checklistId": {
      "type": "string",
      "description": "Checklist ID"
    }
  }
}

clickup_delete_checklist

Delete a checklist.

Args:

checklistId: The checklist ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "checklistId"
  ],
  "properties": {
    "checklistId": {
      "type": "string",
      "description": "Checklist ID to delete"
    }
  }
}

clickup_create_checklist_item

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.

{
  "type": "object",
  "required": [
    "checklistId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Item name"
    },
    "assignee": {
      "type": "number",
      "description": "Assignee user ID"
    },
    "checklistId": {
      "type": "string",
      "description": "Checklist ID"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "checklistId",
    "checklistItemId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "parent": {
      "type": "string",
      "description": "Parent item ID"
    },
    "assignee": {
      "type": "number",
      "description": "Assignee user ID"
    },
    "resolved": {
      "type": "boolean",
      "description": "Resolved status"
    },
    "checklistId": {
      "type": "string",
      "description": "Checklist ID"
    },
    "checklistItemId": {
      "type": "string",
      "description": "Checklist item ID"
    }
  }
}

clickup_delete_checklist_item

Delete a checklist item.

Args:

checklistId: The checklist ID (required)
checklistItemId: The checklist item ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "checklistId",
    "checklistItemId"
  ],
  "properties": {
    "checklistId": {
      "type": "string",
      "description": "Checklist ID"
    },
    "checklistItemId": {
      "type": "string",
      "description": "Checklist item ID to delete"
    }
  }
}

clickup_list_comments

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

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "start": {
      "type": "number",
      "description": "Unix timestamp to start from"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "startId": {
      "type": "string",
      "description": "Comment ID to start from"
    }
  }
}

clickup_delete_comment

Delete a comment.

Args:

commentId: The comment ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "commentId"
  ],
  "properties": {
    "commentId": {
      "type": "string",
      "description": "Comment ID to delete"
    }
  }
}

clickup_set_custom_field

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.

{
  "type": "object",
  "required": [
    "taskId",
    "fieldId",
    "value"
  ],
  "properties": {
    "value": {
      "description": "Field value (type depends on field type)"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "fieldId": {
      "type": "string",
      "description": "Custom field ID"
    }
  }
}

clickup_remove_custom_field

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.

{
  "type": "object",
  "required": [
    "taskId",
    "fieldId"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "fieldId": {
      "type": "string",
      "description": "Custom field ID"
    }
  }
}

clickup_add_dependency

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.

{
  "type": "object",
  "required": [
    "taskId",
    "dependsOn"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "dependsOn": {
      "type": "string",
      "description": "Task ID this task depends on"
    },
    "dependencyOf": {
      "type": "string",
      "description": "Task ID that depends on this task"
    }
  }
}

clickup_delete_dependency

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.

{
  "type": "object",
  "required": [
    "taskId",
    "dependsOn"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "dependsOn": {
      "type": "string",
      "description": "Task ID to remove as dependency"
    },
    "dependencyOf": {
      "type": "string",
      "description": "Task ID that depended on this task"
    }
  }
}

clickup_add_link

Link two tasks together.

Args:

taskId: The task ID (required)
linksTo: The task ID to link to (required)

Returns: Confirmation of link added.

{
  "type": "object",
  "required": [
    "taskId",
    "linksTo"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "linksTo": {
      "type": "string",
      "description": "Task ID to link to"
    }
  }
}

clickup_delete_link

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.

{
  "type": "object",
  "required": [
    "taskId",
    "linksTo"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "linksTo": {
      "type": "string",
      "description": "Linked task ID to remove"
    }
  }
}

clickup_list_task_members

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.

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

clickup_list_list_members

List members of a list.

Args:

listId: The list ID (required)
format: Response format

Returns: List of workspace members with list access.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

clickup_list_goals

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.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "includeCompleted": {
      "type": "boolean",
      "description": "Include completed goals"
    }
  }
}

clickup_get_goal

Get details of a specific goal.

Args:

goalId: The goal ID (required)
format: Response format

Returns: Goal details including key results and progress.

{
  "type": "object",
  "required": [
    "goalId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "goalId": {
      "type": "string",
      "description": "Goal ID"
    }
  }
}

clickup_create_goal

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.

{
  "type": "object",
  "required": [
    "teamId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Goal name"
    },
    "color": {
      "type": "string",
      "description": "Goal color"
    },
    "owners": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Owner user IDs"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "dueDate": {
      "type": "number",
      "description": "Due date (Unix ms)"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "multipleOwners": {
      "type": "boolean",
      "description": "Allow multiple owners"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "goalId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New goal name"
    },
    "color": {
      "type": "string",
      "description": "Goal color"
    },
    "goalId": {
      "type": "string",
      "description": "Goal ID"
    },
    "dueDate": {
      "type": "number",
      "description": "Due date (Unix ms)"
    },
    "addOwners": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "User IDs to add as owners"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "removeOwners": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "User IDs to remove as owners"
    }
  }
}

clickup_delete_goal

Delete a goal.

Args:

goalId: The goal ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "goalId"
  ],
  "properties": {
    "goalId": {
      "type": "string",
      "description": "Goal ID to delete"
    }
  }
}

clickup_list_folderless_lists

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.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "archived": {
      "type": "boolean",
      "description": "Include archived lists"
    }
  }
}

clickup_create_key_result

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.

{
  "type": "object",
  "required": [
    "goalId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Key result name"
    },
    "unit": {
      "type": "string",
      "description": "Unit of measurement"
    },
    "goalId": {
      "type": "string",
      "description": "Goal ID"
    },
    "owners": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Owner user IDs"
    },
    "listIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List IDs to track"
    },
    "taskIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Task IDs to track"
    },
    "stepsEnd": {
      "type": "number",
      "description": "Target value"
    },
    "stepsStart": {
      "type": "number",
      "description": "Starting value"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "keyResultId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name"
    },
    "note": {
      "type": "string",
      "description": "Progress note"
    },
    "keyResultId": {
      "type": "string",
      "description": "Key result ID"
    },
    "stepsCurrent": {
      "type": "number",
      "description": "Current progress value"
    }
  }
}

clickup_delete_key_result

Delete a key result.

Args:

keyResultId: The key result ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "keyResultId"
  ],
  "properties": {
    "keyResultId": {
      "type": "string",
      "description": "Key result ID to delete"
    }
  }
}

clickup_list_teams

List all workspaces/teams the authenticated user has access to.

Returns: List of workspaces with their IDs, names, and member counts.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

clickup_list_spaces

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.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "archived": {
      "type": "boolean",
      "description": "Include archived spaces"
    }
  }
}

clickup_get_space

Get details of a specific space.

Args:

spaceId: The space ID (required)
format: Response format

Returns: Space details including features and statuses.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

clickup_create_space

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.

{
  "type": "object",
  "required": [
    "teamId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Space name"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "multipleAssignees": {
      "type": "boolean",
      "description": "Allow multiple assignees"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New space name"
    },
    "color": {
      "type": "string",
      "description": "New color"
    },
    "private": {
      "type": "boolean",
      "description": "Private setting"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "adminCanManage": {
      "type": "boolean",
      "description": "Admin can manage"
    }
  }
}

clickup_delete_space

Delete a space.

Args:

spaceId: The space ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "spaceId": {
      "type": "string",
      "description": "Space ID to delete"
    }
  }
}

clickup_list_folders

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.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "archived": {
      "type": "boolean",
      "description": "Include archived folders"
    }
  }
}

clickup_get_folder

Get details of a specific folder.

Args:

folderId: The folder ID (required)
format: Response format

Returns: Folder details including lists.

{
  "type": "object",
  "required": [
    "folderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "folderId": {
      "type": "string",
      "description": "Folder ID"
    }
  }
}

clickup_create_folder

Create a new folder in a space.

Args:

spaceId: The space ID (required)
name: Folder name (required)

Returns: The created folder.

{
  "type": "object",
  "required": [
    "spaceId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Folder name"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

clickup_update_folder

Update an existing folder.

Args:

folderId: The folder ID (required)
name: New folder name (required)

Returns: The updated folder.

{
  "type": "object",
  "required": [
    "folderId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New folder name"
    },
    "folderId": {
      "type": "string",
      "description": "Folder ID"
    }
  }
}

clickup_get_list

Get details of a specific list.

Args:

listId: The list ID (required)
format: Response format

Returns: List details including task count and status.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

clickup_create_list

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.

{
  "type": "object",
  "required": [
    "folderId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "List name"
    },
    "status": {
      "type": "string",
      "description": "Default status"
    },
    "content": {
      "type": "string",
      "description": "List description"
    },
    "dueDate": {
      "type": "number",
      "description": "Due date (Unix ms)"
    },
    "assignee": {
      "type": "number",
      "description": "Default assignee ID"
    },
    "folderId": {
      "type": "string",
      "description": "Folder ID"
    },
    "priority": {
      "type": "number",
      "description": "Priority level"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "spaceId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "List name"
    },
    "status": {
      "type": "string",
      "description": "Default status"
    },
    "content": {
      "type": "string",
      "description": "List description"
    },
    "dueDate": {
      "type": "number",
      "description": "Due date (Unix ms)"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "assignee": {
      "type": "number",
      "description": "Default assignee ID"
    },
    "priority": {
      "type": "number",
      "description": "Priority level"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New list name"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "content": {
      "type": "string",
      "description": "New description"
    },
    "dueDate": {
      "type": "number",
      "description": "Due date (Unix ms)"
    },
    "assignee": {
      "type": "number",
      "description": "Default assignee ID"
    },
    "priority": {
      "type": "number",
      "description": "Priority level"
    }
  }
}

clickup_delete_list

Delete a list.

Args:

listId: The list ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID to delete"
    }
  }
}

clickup_list_tags

List all tags in a space.

Args:

spaceId: The space ID (required)
format: Response format

Returns: List of tags available in the space.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

clickup_create_tag

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.

{
  "type": "object",
  "required": [
    "spaceId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Tag name"
    },
    "tagBg": {
      "type": "string",
      "description": "Background color (hex)"
    },
    "tagFg": {
      "type": "string",
      "description": "Foreground color (hex)"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "spaceId",
    "tagName",
    "newName"
  ],
  "properties": {
    "tagBg": {
      "type": "string",
      "description": "Background color (hex)"
    },
    "tagFg": {
      "type": "string",
      "description": "Foreground color (hex)"
    },
    "newName": {
      "type": "string",
      "description": "New tag name"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "tagName": {
      "type": "string",
      "description": "Current tag name"
    }
  }
}

clickup_delete_tag

Delete a tag from a space.

Args:

spaceId: The space ID (required)
tagName: The tag name to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "spaceId",
    "tagName"
  ],
  "properties": {
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    },
    "tagName": {
      "type": "string",
      "description": "Tag name to delete"
    }
  }
}

clickup_add_tag_to_task

Add a tag to a task.

Args:

taskId: The task ID (required)
tagName: The tag name to add (required)

Returns: Confirmation of tag added.

{
  "type": "object",
  "required": [
    "taskId",
    "tagName"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "tagName": {
      "type": "string",
      "description": "Tag name to add"
    }
  }
}

clickup_remove_tag_from_task

Remove a tag from a task.

Args:

taskId: The task ID (required)
tagName: The tag name to remove (required)

Returns: Confirmation of tag removed.

{
  "type": "object",
  "required": [
    "taskId",
    "tagName"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "tagName": {
      "type": "string",
      "description": "Tag name to remove"
    }
  }
}

clickup_list_tasks

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

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 0,
      "description": "Page number (0-indexed)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by tag names"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "archived": {
      "type": "boolean",
      "description": "Include archived tasks"
    },
    "statuses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by status names"
    },
    "subtasks": {
      "type": "boolean",
      "description": "Include subtasks"
    },
    "assignees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by assignee IDs"
    },
    "dueDateGt": {
      "type": "number",
      "description": "Due date after (Unix ms)"
    },
    "dueDateLt": {
      "type": "number",
      "description": "Due date before (Unix ms)"
    },
    "includeClosed": {
      "type": "boolean",
      "description": "Include closed tasks"
    }
  }
}

clickup_search_tasks

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

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 0,
      "description": "Page number (0-indexed)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by tag names"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "listIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by list IDs"
    },
    "spaceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by space IDs"
    },
    "statuses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by status names"
    },
    "subtasks": {
      "type": "boolean",
      "description": "Include subtasks"
    },
    "assignees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by assignee IDs"
    },
    "dueDateGt": {
      "type": "number",
      "description": "Due date after (Unix ms)"
    },
    "dueDateLt": {
      "type": "number",
      "description": "Due date before (Unix ms)"
    },
    "folderIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by folder IDs"
    },
    "includeClosed": {
      "type": "boolean",
      "description": "Include closed tasks"
    }
  }
}

clickup_get_task

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.

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "includeSubtasks": {
      "type": "boolean",
      "description": "Include subtasks"
    },
    "includeMarkdownDescription": {
      "type": "boolean",
      "description": "Include markdown description"
    }
  }
}

clickup_create_task

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.

{
  "type": "object",
  "required": [
    "listId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Task name"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag names"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "parent": {
      "type": "string",
      "description": "Parent task ID for subtask"
    },
    "status": {
      "type": "string",
      "description": "Status name"
    },
    "dueDate": {
      "type": "number",
      "description": "Due date (Unix ms)"
    },
    "priority": {
      "type": "integer",
      "maximum": 4,
      "minimum": 1,
      "description": "Priority (1-4)"
    },
    "assignees": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Assignee user IDs"
    },
    "notifyAll": {
      "type": "boolean",
      "description": "Notify all assignees"
    },
    "startDate": {
      "type": "number",
      "description": "Start date (Unix ms)"
    },
    "description": {
      "type": "string",
      "description": "Task description"
    },
    "timeEstimate": {
      "type": "number",
      "description": "Time estimate (ms)"
    },
    "markdownDescription": {
      "type": "string",
      "description": "Markdown description"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New task name"
    },
    "status": {
      "type": "string",
      "description": "New status name"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "dueDate": {
      "type": "number",
      "description": "Due date (Unix ms or null)"
    },
    "archived": {
      "type": "boolean",
      "description": "Archive/unarchive task"
    },
    "priority": {
      "type": "integer",
      "maximum": 4,
      "minimum": 1,
      "description": "Priority (1-4 or null)"
    },
    "startDate": {
      "type": "number",
      "description": "Start date (Unix ms or null)"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "addAssignees": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "User IDs to add"
    },
    "timeEstimate": {
      "type": "number",
      "description": "Time estimate (ms or null)"
    },
    "removeAssignees": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "User IDs to remove"
    }
  }
}

clickup_delete_task

Delete a task.

Args:

taskId: The task ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "taskId": {
      "type": "string",
      "description": "Task ID to delete"
    }
  }
}

clickup_list_time_entries

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

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "listId": {
      "type": "string",
      "description": "Filter by list ID"
    },
    "taskId": {
      "type": "string",
      "description": "Filter by task ID"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "endDate": {
      "type": "number",
      "description": "End date (Unix ms)"
    },
    "spaceId": {
      "type": "string",
      "description": "Filter by space ID"
    },
    "assignee": {
      "type": "number",
      "description": "Filter by user ID"
    },
    "folderId": {
      "type": "string",
      "description": "Filter by folder ID"
    },
    "startDate": {
      "type": "number",
      "description": "Start date (Unix ms)"
    },
    "includeTaskTags": {
      "type": "boolean",
      "description": "Include task tags"
    },
    "includeLocationNames": {
      "type": "boolean",
      "description": "Include location names"
    }
  }
}

clickup_get_time_entry

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.

{
  "type": "object",
  "required": [
    "teamId",
    "timerId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "timerId": {
      "type": "string",
      "description": "Time entry ID"
    }
  }
}

clickup_create_time_entry

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.

{
  "type": "object",
  "required": [
    "teamId",
    "start",
    "duration"
  ],
  "properties": {
    "end": {
      "type": "number",
      "description": "End time (Unix ms)"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag names"
    },
    "start": {
      "type": "number",
      "description": "Start time (Unix ms)"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "billable": {
      "type": "boolean",
      "description": "Billable"
    },
    "duration": {
      "type": "number",
      "description": "Duration (ms)"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

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

{
  "type": "object",
  "required": [
    "teamId",
    "timerId"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "timerId": {
      "type": "string",
      "description": "Time entry ID to delete"
    }
  }
}

clickup_start_timer

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.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag names"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "billable": {
      "type": "boolean",
      "description": "Billable"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

clickup_stop_timer

Stop the currently running time tracking timer.

Args:

teamId: The workspace/team ID (required)

Returns: The stopped time entry with duration.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    }
  }
}

clickup_get_running_timer

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.

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    }
  }
}

clickup_list_space_views

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.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

clickup_list_folder_views

List all views in a folder.

Args:

folderId: The folder ID (required)
format: Response format

Returns: List of views available in the folder.

{
  "type": "object",
  "required": [
    "folderId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "folderId": {
      "type": "string",
      "description": "Folder ID"
    }
  }
}

clickup_list_list_views

List all views in a list.

Args:

listId: The list ID (required)
format: Response format

Returns: List of views available in the list.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

clickup_get_view

Get details of a specific view.

Args:

viewId: The view ID (required)
format: Response format

Returns: View details including settings and filters.

{
  "type": "object",
  "required": [
    "viewId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "viewId": {
      "type": "string",
      "description": "View ID"
    }
  }
}

clickup_get_view_tasks

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.

{
  "type": "object",
  "required": [
    "viewId"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 0,
      "description": "Page number (0-indexed)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "viewId": {
      "type": "string",
      "description": "View ID"
    }
  }
}

clickup_create_webhook

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.

{
  "type": "object",
  "required": [
    "teamId",
    "endpoint",
    "events"
  ],
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Event types to subscribe to"
    },
    "listId": {
      "type": "string",
      "description": "Filter to specific list"
    },
    "taskId": {
      "type": "string",
      "description": "Filter to specific task"
    },
    "teamId": {
      "type": "string",
      "description": "Workspace/Team ID"
    },
    "spaceId": {
      "type": "string",
      "description": "Filter to specific space"
    },
    "endpoint": {
      "type": "string",
      "description": "Webhook endpoint URL"
    },
    "folderId": {
      "type": "string",
      "description": "Filter to specific folder"
    }
  }
}

clickup_update_webhook

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.

{
  "type": "object",
  "required": [
    "webhookId"
  ],
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New event types"
    },
    "status": {
      "enum": [
        "active",
        "inactive"
      ],
      "type": "string",
      "description": "Webhook status"
    },
    "endpoint": {
      "type": "string",
      "description": "New endpoint URL"
    },
    "webhookId": {
      "type": "string",
      "description": "Webhook ID"
    }
  }
}

clickup_delete_webhook

Delete a webhook.

Args:

webhookId: The webhook ID to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "webhookId"
  ],
  "properties": {
    "webhookId": {
      "type": "string",
      "description": "Webhook ID to delete"
    }
  }
}