The server marks this tool destructive: it may delete or overwrite data

clickup_create_task

WRITE: create a new task in a list. `name` is required; the list is the {list_id} path param, not a body field. ClickUp REST: POST /list/{list_id}/task.

destructive

Argument	Type	Description
name*	string	The task name (required).
tags	array	Tag names to attach.
parent	string	Parent task id — set to create this task as a subtask.
status	string	Status name (must be a valid status in the list).
list_id*	string	The list id to create the task in (path param, not body).
due_date	integer	Due date as Unix time in ms.
priority	integer	Task priority: 1=Urgent, 2=High, 3=Normal, 4=Low.
assignees	array	User ids to assign the task to (numeric).
start_date	integer	Start date as Unix time in ms.
description	string	The task description / body text.
due_date_time	boolean	Whether due_date carries a time component (else date-only).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The task name (required)."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tag names to attach."
    },
    "parent": {
      "type": "string",
      "description": "Parent task id — set to create this task as a subtask."
    },
    "status": {
      "type": "string",
      "description": "Status name (must be a valid status in the list)."
    },
    "list_id": {
      "type": "string",
      "description": "The list id to create the task in (path param, not body)."
    },
    "due_date": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Due date as Unix time in ms."
    },
    "priority": {
      "type": "integer",
      "maximum": 4,
      "minimum": 1,
      "description": "Task priority: 1=Urgent, 2=High, 3=Normal, 4=Low."
    },
    "assignees": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991
      },
      "description": "User ids to assign the task to (numeric)."
    },
    "start_date": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Start date as Unix time in ms."
    },
    "description": {
      "type": "string",
      "description": "The task description / body text."
    },
    "due_date_time": {
      "type": "boolean",
      "description": "Whether due_date carries a time component (else date-only)."
    }
  }
}

clickup_create_task_comment

WRITE: add a comment to a task. `comment_text` is required; the task is the {task_id} path param. ClickUp REST: POST /task/{task_id}/comment.

destructive

Argument	Type	Description
task_id*	string	The task id to comment on (path param, not body).
assignee	integer	User id to assign the comment to (numeric).
notify_all	boolean	If true, notify everyone tagged/subscribed (else just the assignee).
comment_text*	string	The comment text (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "task_id",
    "comment_text"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "description": "The task id to comment on (path param, not body)."
    },
    "assignee": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "User id to assign the comment to (numeric)."
    },
    "notify_all": {
      "type": "boolean",
      "description": "If true, notify everyone tagged/subscribed (else just the assignee)."
    },
    "comment_text": {
      "type": "string",
      "description": "The comment text (required)."
    }
  }
}

clickup_get_authorized_user

Get the user associated with the current ClickUp API token. ClickUp REST: GET /user.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

clickup_get_list_comments

Get the comments on a list. ClickUp REST: GET /list/{list_id}/comment.

read-only

Argument	Type	Description
list_id*	string	The list id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "list_id"
  ],
  "properties": {
    "list_id": {
      "type": "string",
      "description": "The list id."
    }
  }
}

clickup_get_task

Get a single task by id. ClickUp REST: GET /task/{task_id}.

read-only

Argument	Type	Description
task_id*	string	The task id.
include_subtasks	boolean	Include the task's subtasks (serialized true/false).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "description": "The task id."
    },
    "include_subtasks": {
      "type": "boolean",
      "description": "Include the task's subtasks (serialized true/false)."
    }
  }
}

clickup_get_task_comments

Get the comments on a task. ClickUp REST: GET /task/{task_id}/comment.

read-only

Argument	Type	Description
task_id*	string	The task id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "description": "The task id."
    }
  }
}

clickup_get_tasks

Get the tasks in a list, with optional filters and pagination. ClickUp REST: GET /list/{list_id}/task.

read-only

Argument	Type	Description
page	integer	0-indexed page number for pagination.
list_id*	string	The list id.
reverse	boolean	Reverse the sort order (serialized true/false).
archived	boolean	Include archived items — serialized as archived=true/false. Default false.
order_by	string	Sort field, e.g. 'created', 'updated', 'due_date', 'id'.
statuses	array	Filter by status names (repeated statuses[] params), e.g. ["open","in progress"].
subtasks	boolean	Include subtasks (serialized true/false).
assignees	array	Filter by assignee user ids (repeated assignees[] params).
due_date_gt	integer	Only tasks due after this Unix time in ms.

clickup_list_folderless_lists

List the lists that live directly in a space (not inside a folder). ClickUp REST: GET /space/{space_id}/list.

read-only

Argument	Type	Description
archived	boolean	Include archived items — serialized as archived=true/false. Default false.
space_id*	string	The space id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "space_id"
  ],
  "properties": {
    "archived": {
      "type": "boolean",
      "description": "Include archived items — serialized as archived=true/false. Default false."
    },
    "space_id": {
      "type": "string",
      "description": "The space id."
    }
  }
}

clickup_list_folders

List folders in a space. ClickUp REST: GET /space/{space_id}/folder.

read-only

Argument	Type	Description
archived	boolean	Include archived items — serialized as archived=true/false. Default false.
space_id*	string	The space id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "space_id"
  ],
  "properties": {
    "archived": {
      "type": "boolean",
      "description": "Include archived items — serialized as archived=true/false. Default false."
    },
    "space_id": {
      "type": "string",
      "description": "The space id."
    }
  }
}

clickup_list_lists

List the lists inside a folder. ClickUp REST: GET /folder/{folder_id}/list.

read-only

Argument	Type	Description
archived	boolean	Include archived items — serialized as archived=true/false. Default false.
folder_id*	string	The folder id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "folder_id"
  ],
  "properties": {
    "archived": {
      "type": "boolean",
      "description": "Include archived items — serialized as archived=true/false. Default false."
    },
    "folder_id": {
      "type": "string",
      "description": "The folder id."
    }
  }
}

clickup_list_spaces

List spaces in a workspace (team). ClickUp REST: GET /team/{team_id}/space.

read-only

Argument	Type	Description
team_id*	string	The workspace (team) id.
archived	boolean	Include archived items — serialized as archived=true/false. Default false.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "team_id"
  ],
  "properties": {
    "team_id": {
      "type": "string",
      "description": "The workspace (team) id."
    },
    "archived": {
      "type": "boolean",
      "description": "Include archived items — serialized as archived=true/false. Default false."
    }
  }
}

clickup_list_workspaces

List the workspaces (the ClickUp API calls these "teams") the token can access — their ids are the team_id used by other tools. ClickUp REST: GET /team.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

clickup_search_tasks

Search/filter tasks across a whole workspace (team), optionally scoped to spaces/folders/lists. ClickUp's "Get Filtered Team Tasks". ClickUp REST: GET /team/{team_id}/task.

read-only

Argument	Type	Description
page	integer	0-indexed page number for pagination.
reverse	boolean	Reverse the sort order (serialized true/false).
team_id*	string	The workspace (team) id.
list_ids	array	Restrict to these list ids (repeated list_ids[] params).
order_by	string	Sort field, e.g. 'created', 'updated', 'due_date', 'id'.
statuses	array	Filter by status names (repeated statuses[] params), e.g. ["open","in progress"].
assignees	array	Filter by assignee user ids (repeated assignees[] params).
space_ids	array	Restrict to these space ids (repeated space_ids[] params).
due_date_gt

clickup_update_task

WRITE: update fields on an existing task. Only the fields you pass are changed. ClickUp REST: PUT /task/{task_id}.

destructive

Argument	Type	Description
name	string	New task name.
parent	string	Parent task id (re-parent as a subtask).
status	string	New status name (must be valid for the list).
task_id*	string	The task id to update (path param, not body).
archived	boolean	Archive (true) or unarchive (false) the task.
due_date	integer	Due date as Unix time in ms.
priority	integer	Task priority: 1=Urgent, 2=High, 3=Normal, 4=Low.
start_date	integer	Start date as Unix time in ms.
description	string	New task description / body text.
due_date_time

ClickUp MCP by usefulapi

Try it

clickup_create_task Destructive

ClickUp MCP by usefulapi

Try it

clickup_create_task Destructive

Tools (14)