List all Teams/Workspaces the authorized token can access, including members. Use this first to discover team_id values.

Get seat usage for a Workspace — how many member and guest seats are used vs. the total available on the current plan. Use to check capacity before inviting people.

Get the current subscription plan (name and id) of a Workspace, e.g. Free, Unlimited, Business. Use to know which features and limits apply.

List all members (users) of a Workspace with their ids, emails and roles. Useful for resolving assignees.

List the custom task types defined in a Workspace (e.g. Bug, Feature, Milestone). Returns each type's id and name. Use to find a custom_item_id when creating tasks of a specific type.

Get the profile of the user that owns the configured API token — id, username, email and color. Use to identify 'me' for self-assignment or filtering by the current user.

List all Spaces in a Workspace, with each Space's id, name, privacy and enabled features. Spaces are the top level of the ClickUp hierarchy (Space → Folder → List → Task). Use to discover a space_id.

Get a single Space by id, including its name, privacy, assignee settings and enabled features. Use to inspect a Space's configuration.

Create a new Space in a Workspace. Optionally enable multiple assignees and toggle features. Returns the created Space with its id. Use to start a new top-level area of work.

Update a Space — rename it, change its privacy, assignee mode, admin permissions, or feature toggles. Only the provided fields change. Returns the updated Space.

Permanently delete a Space and everything inside it (Folders, Lists, tasks). This cannot be undone. Returns a confirmation with the deleted Space id.

List all Folders inside a Space, with each Folder's id, name and the Lists it contains. Folders group Lists within a Space. Use to discover a folder_id.

Get a single Folder by id, including its name and the Lists it contains (with their ids and task counts). Use to inspect a Folder or enumerate its Lists.

Create an empty Folder inside a Space. Returns the created Folder with its id. Use to group related Lists together.

Create a Folder in a Space from a Folder template, reproducing the template's Lists, statuses and structure. Returns the created Folder. Use to spin up a standardized project layout.

Rename a Folder. Returns the updated Folder. Use to change a Folder's display name.

Permanently delete a Folder and all Lists and tasks inside it. This cannot be undone. Returns a confirmation with the deleted Folder id.

List the Views configured on a Folder (List, Board, Calendar, Gantt, etc.), with each View's id and type. Use to find a view_id to read tasks from.

List all Lists inside a Folder, with each List's id, name and task count. Use to discover a list_id within a Folder.

List all folderless Lists that live directly under a Space (not inside any Folder), with their ids and names. Use to find Lists that aren't grouped in a Folder.

Get a single List by id, including its name, content, statuses, task count and settings. Use to inspect a List before creating or filtering tasks in it.

Create a new List inside a Folder, optionally setting its description, due date, priority, default assignee and status. Returns the created List with its id.

Create a new List directly under a Space (not inside any Folder), optionally setting description, due date, priority, default assignee and status. Returns the created List with its id.

Create a List in a Folder from a List template, reproducing the template's statuses, fields and (optionally) tasks. Returns the created List. Use to spin up a standardized List layout.

Update a List — change its name, content, due date, priority, default assignee or status. Only the provided fields change. Returns the updated List.

Permanently delete a List and all tasks inside it. This cannot be undone. Returns a confirmation with the deleted List id.

List the Views configured on a List (List, Board, Calendar, etc.), with each View's id and type. Use to find a view_id to read tasks as that View shows them.

Get tasks in a specific List with rich filtering — by status, assignees, tags, and due/created/updated date ranges — plus ordering, subtasks and custom-field filters. Paginated. Use when you know which List the tasks live in.

Get a single task by id with full detail — status, assignees, custom fields, dates, and optionally subtasks and the markdown description. Use to inspect one known task.

Search tasks across the entire Workspace with filters (Spaces, Folders, Lists, statuses, assignees, tags, due dates). This is the deep search to use when you don't know which List a task is in. Paginated.

Create a new task in a List, setting any fields you provide (description, status, priority, dates, assignees, tags, custom fields, parent for subtasks). Returns the created task with its id.

Update any field of a task — pass only the fields you want to change. For assignees, assignees replaces the whole set, while assignees_add/assignees_rem change them incrementally. Returns the updated task.

Permanently delete a task by id. This cannot be undone. Returns a confirmation with the deleted task id.

Get the subtasks of a parent task. Returns the parent task with its subtasks included. Use to enumerate a task's children.

Duplicate a task into a target List by reading the source and re-creating it (name, description, status, priority, assignees, tags and dates). Returns the new task. The copy is named ' (copy)' unless you override it.

Set (or overwrite) a custom field's value on a task. The value shape depends on the field type (text/number primitive, drop_down option id, labels array, date epoch ms, users array). Look up the type with a get_*_custom_fields tool first.

Clear a custom field's value on a task, resetting it to empty. Returns a confirmation with the task and field ids.

List the members who have access to a task, with their ids, usernames and emails. Use to see who can view or be assigned to the task.

Create many tasks in a single List in one call (up to 100). Runs with bounded concurrency and returns a per-task success/error report, so a partial failure never loses the rest of the batch. Use to import or scaffold many tasks at once.

Apply the same set of field changes to many tasks at once (up to 100). Returns a per-task success/error report. Use to mass-change status, priority, due date, or add/remove assignees across a batch of tasks.

Permanently delete many tasks at once (up to 100). This cannot be undone. Returns a per-task success/error report so you can see exactly which deletions succeeded.

Add many tasks to a target List at once (up to 100), using ClickUp's multi-list association (the tasks also remain in their original List). Returns a per-task success/error report.

Link two tasks together with a plain (non-dependency) relationship, so they reference each other. Use for 'related to' connections that don't imply blocking order. Returns the linked task.

Remove a plain link between two tasks (created by add_task_link). Returns a confirmation. Does not affect dependencies.

Create a blocking dependency between tasks. Provide depends_on to make this task wait on another (this is blocked until that finishes), or dependency_of to make this task block another. Exactly one is required. Returns a confirmation.

Remove a blocking dependency between tasks. Provide the same depends_on or dependency_of used to create it (exactly one is required). Returns a confirmation.

Add an existing task to an additional List (ClickUp's 'Tasks in Multiple Lists' feature), so it appears in more than one List without being moved. Returns a confirmation.

Remove a task from an additional List it was added to via 'Tasks in Multiple Lists'. The task remains in its home List. Returns a confirmation.

List all comments on a task, newest first. Returns each comment's id, text, author, creation date, assignee and resolved state. Use to read a task's discussion history before replying or to audit activity. Supports cursor pagination via start + start_id.

Post a new comment on a task. Optionally assign it to a user and notify all watchers. Returns the created comment's id. Use to leave feedback, ask questions or record an update directly on a task.

List all comments attached to a List (List-level discussion, separate from individual task comments), newest first. Returns each comment's id, text, author and date.

Post a new comment on a List. Optionally assign it to a user and notify watchers. Returns the created comment's id. Use for List-level notes that don't belong to a specific task.

List all messages in a legacy Chat view (a view of type 'chat'), newest first. Returns each message's id, text, author and date. Use for ClickUp's older chat-on-a-view feature (not the newer v3 Chat channels).

Post a message into a legacy Chat view. Optionally notify all members of the view. Returns the created message's id.

Edit an existing comment: change its text, reassign it, or mark it resolved/unresolved. Only the fields you provide are changed. Returns the updated comment. Works for task, List and Chat-view comments.

Permanently delete a comment by id. This cannot be undone. Returns a confirmation object with the deleted comment id.

List the threaded replies under a parent comment, oldest first. Returns each reply's id, text, author and date. Use to read a full comment thread after spotting a parent comment.

Reply to an existing comment, creating a threaded response under it. Optionally assign the reply and notify watchers. Returns the created reply's id.

Create a checklist (a named group of sub-items) on a task. Returns the created checklist with its id. Use to add a structured to-do list inside a task, then add items with create_checklist_item.

Rename a checklist and/or change its position among the task's checklists. Only the provided fields change. Returns the updated checklist.

Permanently delete a checklist and all its items from a task. This cannot be undone. Returns a confirmation with the deleted checklist id.

Add a single item (a checkable line) to an existing checklist, optionally assigned to a user. Returns the updated checklist. Use after create_checklist to populate it.

Edit a checklist item — change its text, assignee, resolved (checked) state, or nest it under a parent item. Only the provided fields change. Returns the updated checklist.

Permanently delete a single item from a checklist. This cannot be undone. Returns a confirmation with the deleted item id.

Attach a file to a task. Provide exactly one source: file_path (local), url (remote file to fetch), or base64 (raw content). file_name is required when using base64.

List the attachments currently on a task (read from the task object — ClickUp returns attachments inline).

List all tags defined in a Space, with each tag's name and colors. Tags live at the Space level and can be applied to any task in it. Use to discover available tag names before tagging a task.

Create a new tag in a Space with optional foreground/background colors. The tag becomes available to all tasks in the Space. Returns the created tag.

Update an existing Space tag — rename it and/or change its colors. Identify it by its current name. Returns the updated tag.

Delete a tag from a Space by name, removing it from every task it was applied to. This cannot be undone. Returns a confirmation with the deleted tag name.

Apply an existing Space tag to a task. The tag must already exist in the task's Space (create it first with create_space_tag if needed). Returns a confirmation.

Remove a tag from a task without deleting the tag from the Space. Returns a confirmation. Use to untag a single task.

List the custom fields available on a List, with each field's id, name, type and type configuration (e.g. dropdown options, currency settings). Use to discover a field_id and its valid values before setting it on a task.

List the custom fields accessible at the Folder level, with their ids, names, types and configuration. Use to discover fields inherited by the Folder's Lists.

List the custom fields accessible at the Space level, with their ids, names, types and configuration. Use to discover Space-wide fields.

List the custom fields accessible at the Workspace/Team level, with their ids, names, types and configuration. Use to discover org-wide fields.

Set (or overwrite) a custom field's value on a task. The value shape depends on the field type: text/number → primitive; drop_down → the option id; labels → array of option ids; date → epoch milliseconds; users → array of user ids. Look up the field type first with one of the get_*_custom_fields tools.

Clear a custom field's value on a task, resetting it to empty. Returns a confirmation with the task and field ids. Use to unset a field rather than overwrite it.

List time entries in a Workspace within a date range, optionally filtered by assignee, task, List, Folder or Space. Returns each entry's id, duration, user, task and billable flag. Use to build timesheets or audit logged time.

Get a single time entry by id, including its duration, start, user, task and tags. Use to inspect one logged interval.

Get the timer that is currently running for a user (defaults to the token owner). Returns the active entry or empty if no timer is running. Use to check whether a timer is on before starting/stopping.

Start a live timer for the token owner, optionally bound to a task and marked billable. Returns the started entry. Stop it later with stop_time_entry.

Stop the timer currently running for the token owner and persist the logged interval. Returns the completed entry. No-op error if no timer is running.

Create a manual time entry with an explicit start time and duration (no live timer needed). Optionally tie it to a task, user, billable flag and tags. Returns the created entry. Use to log time after the fact.

Update an existing time entry — change its description, start, duration, billable flag, tags or linked task. Only the provided fields change. Returns the updated entry.

Permanently delete a time entry by id. This cannot be undone. Returns a confirmation with the deleted entry id.

Get the change history of a time entry — who edited it and what changed over time. Use to audit edits to logged time.

List all time-entry tags defined in a Workspace, with their names and colors. Use to discover available tags before tagging entries.

Add one or more tags to one or more time entries at once. Returns a confirmation. Use to categorize logged time (e.g. 'billable', 'meeting').

Remove one or more tags from one or more time entries at once. Returns a confirmation.

Get how long a single task has spent in each of its statuses, plus the current status duration. Use to analyze cycle time or where a task is stuck.

Get time-in-status data for multiple tasks in one call. Returns per-task status durations. Use to compare cycle time across a set of tasks.

Search or list Docs in a Workspace (ClickUp Docs v3). Returns matching Docs with their ids, titles and locations. Use to find a doc_id by keyword or to browse Docs under a parent. Paginate with cursor.

Get a single Doc's metadata by id (ClickUp Docs v3) — its title, parent location and settings. Use get_doc_pages to read the actual content.

Create a new Doc in a Workspace (ClickUp Docs v3), optionally nested under a Space/Folder/List and with a visibility setting. Returns the created Doc with its id. Add pages afterwards with create_doc_page.

Get the page tree of a Doc (ClickUp Docs v3) — page ids, titles and their nesting hierarchy, without the full content. Use to navigate a Doc's structure before fetching a specific page.

Get every page of a Doc together with its full content (ClickUp Docs v3). Returns content as markdown by default. Use to read an entire Doc at once.

Get a single page of a Doc with its content (ClickUp Docs v3). Returns content as markdown by default. Use after get_doc_page_listing to read one specific page.

Create a new page inside a Doc (ClickUp Docs v3), optionally nested under an existing page and with initial content. Returns the created page with its id.

Update a Doc page's title, subtitle or content (ClickUp Docs v3). Use content_edit_mode to replace, append to, or prepend the existing content. Only the provided fields change. Returns the updated page.