ClickUp MCP Pro

Post a message into a legacy Chat view. Optionally notify all members of the view. Returns the created message'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`.

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.

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

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.

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.

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 new Goal in a Workspace with optional due date, description, owners and color. Returns the created Goal with its id. Add measurable targets afterwards with `create_key_result`.

Add a key result (a measurable target) to a Goal. Choose its measurement `type` and, for numeric types, the start/end steps and unit. Can be tied to tasks or Lists for automatic tracking. Returns the created key result.

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.

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.

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

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.

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.

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.

Create a new task in a List from an existing task template, copying the template's structure (subtasks, checklists, custom fields). Returns the created task. Use after `get_task_templates` to obtain the `template_id`.

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

Create a new User Group (Team) in a Workspace with an initial set of members. Returns the created group with its id and handle. Use to organize people for mentions and bulk assignment.

Create a new View on a Team, Space, Folder or List. Provide exactly one parent id (team_id, space_id, folder_id or list_id) to choose where it lives. Returns the created View. Use to save a reusable filtered/grouped layout.

Create a webhook that POSTs event payloads to your HTTPS endpoint. Optionally scope it to a single space, folder, list or task; omit all scopes to watch the whole Workspace. Returns the created webhook with its id and signing secret.

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.

Permanently delete a Chat message by id (ClickUp Chat v3). This cannot be undone. Returns a confirmation with the deleted message id.

Remove a specific emoji reaction (added by the current user) from a Chat message (ClickUp Chat v3). Returns a confirmation.

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

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

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

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

Permanently delete a Goal and its key results. This cannot be undone. Returns a confirmation with the deleted Goal id.

Permanently delete a key result from its Goal. This cannot be undone. Returns a confirmation with the deleted key result id.

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

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

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.

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

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.

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

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

Permanently delete a User Group by id. Members are not deleted, only the grouping. This cannot be undone. Returns a confirmation with the deleted group id.

Permanently delete a View by id. The underlying tasks are not affected, only the saved View. This cannot be undone. Returns a confirmation with the deleted View id.

Permanently delete a webhook by id, stopping all future event delivery to its endpoint. This cannot be undone. Returns a confirmation with the deleted webhook id.

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 '<name> (copy)' unless you override it.

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

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.

Edit a guest's Workspace-level capabilities (tags, time visibility, view creation). Only the provided flags change. Returns the updated guest. Enterprise plan only.

Resolve a List id from its name within a Space (searches folders + folderless lists).

Resolve a Workspace member by name, username or email and return their user object (with id). Useful before assigning tasks.

Resolve a Space id from its name (case-insensitive).

Find the currently active sprint in a Sprint Folder — the List whose start/due date range contains now.

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

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.

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.

Get a single Chat channel by id (ClickUp Chat v3) — its name, description, topic, visibility and location. Use to inspect a channel's settings.

List the followers of a Chat channel (ClickUp Chat v3) — users who receive notifications without necessarily being members. Paginated via `cursor`/`limit`.

List the members of a Chat channel (ClickUp Chat v3), with their user ids and names. Paginated via `cursor`/`limit`. Use to see who is in a channel.

List the emoji reactions on a Chat message (ClickUp Chat v3), with who reacted and which emoji. Paginated via `cursor`/`limit`.

List the threaded replies to a Chat message (ClickUp Chat v3). Returns each reply's id, content, author and timestamp. Paginated via `cursor`/`limit`.

List the users @-mentioned/tagged in a Chat message (ClickUp Chat v3), with their ids and names. Paginated via `cursor`/`limit`.

List the messages in a Chat channel, newest first (ClickUp Chat v3). Returns each message's id, content, author and timestamp. Paginated via `cursor`/`limit`. Use to read a channel's history.

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

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

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.

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

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 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 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 Goal by id, including its key results (targets) and current progress. Use to inspect a Goal's details and its key_result ids.

List the Goals in a Workspace, with each Goal's id, name, due date, owners and progress. Goals track outcomes via key results. Use to find a `goal_id`.

Get a guest's details by id — their email, capabilities and the items shared with them. Enterprise plan only.

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.

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.

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 members who have access to a List (the users assignable to tasks in it), with ids, usernames and emails.

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.

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

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.

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

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

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.

List all Views defined on a Space, with each View's id, name and type. Use to find a `view_id` scoped to a Space.

Get the tasks of a sprint, i.e. the tasks contained in the sprint's List. Returns the task list with status, assignees and dates. Use to review sprint scope or progress.

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

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.

List the members who can be assigned to a given task, with their ids, usernames and emails. Use to validate or resolve an assignee before updating a task.

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

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.

List the task templates available in a Workspace, paginated. Returns each template's id and name. Use to discover a `template_id` before creating a task from a template.

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

List all Views at the Workspace/Everything level, with each View's id, name and type. Use to find a `view_id` for reading tasks across the whole Workspace.

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.

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 change history of a time entry — who edited it and what changed over time. Use to audit edits to logged time.

Get a single View's full definition by id — its type, grouping, sorting, filters and columns. Use to inspect how a View is configured.

Get the tasks visible in a View, with the View's own filters and sorting applied, paginated. Returns the task list. Use this to read tasks exactly as a saved View shows them.

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

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

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

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.

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.

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

Invite an external guest to a Workspace by email, with optional capability flags. Returns the created guest. Enterprise plan only. Use to bring in a client/contractor before sharing specific tasks, Lists or Folders with them.

List the Chat channels in a Workspace (ClickUp Chat v3), with each channel's id, name, type and visibility. Use to discover a `channel_id` before reading or sending messages. Paginated via `cursor`/`limit`.

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

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

List the sprints (Lists) inside a Sprint Folder, including their start/due dates.

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

List the User Groups (a.k.a. Teams — named sub-groups of people inside a Workspace) and their members. Returns each group's id, name, handle and member list. Use to find a `group_id` before mentioning or assigning a group.

List the webhooks registered for a Workspace, including each one's id, endpoint URL, subscribed events, scope and health status. Use to audit existing integrations before creating or deleting one.

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.

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.

Remove a guest from a Workspace entirely, revoking all their access. This cannot be undone. Returns a confirmation. Enterprise plan only.

Revoke a guest's access to a Folder. Returns a confirmation. Enterprise plan only.

Revoke a guest's access to a List. Returns a confirmation. Enterprise plan only.

Revoke a guest's access to a single task. Returns a confirmation. Enterprise plan only.

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

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

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

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.

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

Send a new message to a Chat channel (ClickUp Chat v3). Optionally assign it (turning it into an actionable item) and choose message vs. post type. Returns the created message with its id.

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.

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.

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.

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.

Update a Chat channel's name, description, topic, visibility or archived state (ClickUp Chat v3). Only the provided fields change. Returns the updated channel.

Edit a Chat message's content and/or mark it resolved (ClickUp Chat v3). Only the provided fields change. Returns the updated message.

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.

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.

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

Update a Goal — change its name, due date, description, color, and add/remove owners. Only the provided fields change. Returns the updated Goal.

Update a key result's current progress and/or definition — set the latest value, add a note, or rename it. Only the provided fields change. Returns the updated key result.

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

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

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

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.

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.

Update a User Group — rename it, change its handle, and/or add and remove members. Only the provided fields change. Returns the updated group.

Update a View's configuration — its name, grouping, sorting, filters, columns or settings. Only the provided fields change. Returns the updated View.

Update an existing webhook's endpoint URL, subscribed events, and/or active status. Only the provided fields change. Use `status: 'inactive'` to pause delivery without deleting. Returns the updated webhook.

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.