# ClickUp — how to use (mcp.ai)

ClickUp unifies tasks, docs, goals, and chat in a single platform, allowing teams to plan, organize, and collaborate across projects with customizable workflows

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_clickup?ms=1781541720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `clickup_add_dependency`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/clickup`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/clickup/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/clickup/add/dependency` — Adds a 'waiting on' or 'blocking' dependency to a task, requiring either `depends on` (task becomes waiting on) or `dependency of` (task becomes blocking), but not both; `team id` is required if `cust
  - body: { task_id: string, team_id?: integer, depends_on?: string, depedency_of?: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/add/guest/to/folder` — Adds a guest to a folder with specified permissions; requires a clickup enterprise plan.
  - body: { guest_id: integer, folder_id: integer, include_shared?: boolean, permission_level: string }
- `POST https://api.mcp.ai/api/clickup/add/guest/to/list` — Shares a clickup list with an existing guest user, granting them specified permissions; requires the workspace to be on the clickup enterprise plan.
  - body: { list_id: integer, guest_id: integer, include_shared?: boolean, permission_level: string }
- `POST https://api.mcp.ai/api/clickup/add/guest/to/task` — Assigns a guest to a task with specified permissions; requires clickup enterprise plan, and `team id` if `custom task ids` is true.
  - body: { task_id: string, team_id?: integer, guest_id: integer, include_shared?: boolean, custom_task_ids?: boolean, permission_level: string }
- `POST https://api.mcp.ai/api/clickup/add/tag/to/task` — Adds an existing tag to a specified task; team id is required if custom task ids is true.
  - body: { task_id: string, team_id?: integer, tag_name: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/add/tags/from/time/entries` — Associates a list of specified tags with one or more time entries within a given team (workspace).
  - body: { tags: object[], team_id: integer, time_entry_ids: string[] }
- `POST https://api.mcp.ai/api/clickup/add/task/link` — Links two existing and accessible clickup tasks, identified by `task id` (source) and `links to` (target).
  - body: { task_id: string, team_id?: integer, links_to: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/add/task/to/list` — Adds an existing task to an additional clickup list; the "tasks in multiple lists" clickapp must be enabled in the workspace for this.
  - body: { list_id: integer, task_id: string }
- `POST https://api.mcp.ai/api/clickup/attachments/upload/file/to/task/as/attachment` — Deprecated: use `create task attachment` to upload a file to a task; requires `multipart/form-data`.
  - body: { task_id: string, team_id?: integer, attachment?: string[], custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/authorization/get/access/token` — Deprecated: use `get access token` instead. exchanges a clickup oauth 2.0 authorization code for an access token.
  - body: { code: string, client_id: string, client_secret: string }
- `POST https://api.mcp.ai/api/clickup/authorization/get/work/space/list` — Deprecated: use `get authorized teams workspaces` instead to retrieve workspaces (teams) accessible to the authenticated user.
- `POST https://api.mcp.ai/api/clickup/authorization/view/account/details` — Deprecated: use `get authorized user` instead. retrieves details of the authenticated user's clickup account.
- `POST https://api.mcp.ai/api/clickup/change/tag/names/from/time/entries` — Updates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team id`.
  - body: { name: string, tag_bg: string, tag_fg: string, team_id: integer, new_name: string }
- `POST https://api.mcp.ai/api/clickup/create/a/time/entry` — Creates a new time entry for a specified team.
  - body: { end?: integer, tid?: string, stop?: integer, tags?: object[], start: integer, team_Id: integer, team_id?: integer, assignee?: integer, billable?: boolean, duration: integer, description?: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/chat/view/comment` — Posts a new comment to a specified clickup chat view; the 'view id' must correspond to an existing and accessible chat view.
  - body: { view_id: string, notify_all: boolean, comment_text: string }
- `POST https://api.mcp.ai/api/clickup/create/checklist` — Creates a new checklist with a specified name within an existing task, which can be identified by its standard id or a custom task id (if `custom task ids` is true, `team id` is also required).
  - body: { name: string, task_id: string, team_id?: integer, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/checklist/item` — Creates a new checklist item within a specified, existing checklist, optionally setting the item's name and assigning it to a user.
  - body: { name?: string, assignee?: integer, checklist_id: string }
- `POST https://api.mcp.ai/api/clickup/create/folder` — Creates a new clickup folder within the specified space, which must exist and be accessible.
  - body: { name: string, space_id: integer }
- `POST https://api.mcp.ai/api/clickup/create/folder/view` — Creates a new, highly customizable view within a specific clickup folder using its `folder id`.
  - body: { name: string, type: string, folder_id: integer, divide__dir?: null, filters__op?: string, divide__field?: null, grouping__dir?: integer, columns__fields?: string[], filters__fields?: string[], filters__search?: string, grouping__field?: string, sorting__fields?: string[], grouping__ignore?: boolean, divide__collapsed?: boolean, grouping__collapsed?: string[], filters__show__closed?: boolean, settings__me__comments?: boolean, settings__me__subtasks?: boolean, settings__show__images?: boolean, settings__me__checklists?: boolean, settings__show__subtasks?: integer, team__sidebar__assignees?: string[], settings__show__assignees?: boolean, settings__show__task__locations?: boolean, settings__show__closed__subtasks?: boolean, team__sidebar__unassigned__tasks?: boolean, team__sidebar__assigned__comments?: boolean, settings__collapse__empty__columns?: string, settings__show__subtask__parent__names?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/folderless/list` — Creates a new folderless list (a list not part of any folder) directly within a specified clickup space.
  - body: { name: string, status?: string, content?: string, assignee?: integer, due_date?: integer, priority?: integer, space_id: integer, due_date_time?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/goal` — Creates a new goal in a clickup team (workspace).
  - body: { name: string, color: string, owners: integer[], team_id: integer, due_date: integer, description: string, multiple_owners: boolean }
- `POST https://api.mcp.ai/api/clickup/create/key/result` — Creates a new key result (target) for a specified goal in clickup to define and track measurable objectives towards achieving that goal.
  - body: { name: string, type: string, unit: string, owners: integer[], goal_id: string, list_ids: string[], task_ids: string[], steps_end: integer, steps_start: integer }
- `POST https://api.mcp.ai/api/clickup/create/list` — Creates a new list in clickup within a specified, existing folder.
  - body: { name: string, status?: string, content?: string, assignee?: integer, due_date?: integer, priority?: integer, folder_id: integer, due_date_time?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/list/comment` — Adds a new comment with specific text to an existing and accessible clickup list, assigns it to a user, and sets notification preferences for all list members.
  - body: { list_id: integer, assignee: integer, notify_all: boolean, comment_text: string }
- `POST https://api.mcp.ai/api/clickup/create/list/view` — Creates a new, customizable view (e.g., list, board, calendar) within a specified clickup list, requiring an existing list id accessible by the user.
  - body: { name: string, type: string, list_id: integer, divide__dir?: null, filters__op?: string, divide__field?: null, grouping__dir?: integer, columns__fields?: string[], filters__fields?: string[], filters__search?: string, grouping__field?: string, sorting__fields?: string[], grouping__ignore?: boolean, divide__collapsed?: boolean, grouping__collapsed?: string[], filters__show__closed?: boolean, settings__me__comments?: boolean, settings__me__subtasks?: boolean, settings__show__images?: boolean, settings__me__checklists?: boolean, settings__show__subtasks?: integer, team__sidebar__assignees?: string[], settings__show__assignees?: boolean, settings__show__task__locations?: boolean, settings__show__closed__subtasks?: boolean, team__sidebar__unassigned__tasks?: boolean, team__sidebar__assigned__comments?: boolean, settings__collapse__empty__columns?: string, settings__show__subtask__parent__names?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/space` — Creates a new space in a clickup team, with customizable name, privacy, color, and feature settings.
  - body: { name: string, color?: string, private?: boolean, team_id: string, features?: object, multiple_assignees?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/space/tag` — Creates a new tag (name, foreground color, background color) in an existing clickup space.
  - body: { space_id: integer, tag__name?: string, tag__tag__bg?: string, tag__tag__fg?: string }
- `POST https://api.mcp.ai/api/clickup/create/space/view` — Creates a customizable view (e.g., list, board, gantt) within a specified clickup space, allowing configuration of grouping, sorting, filtering, and display settings.
  - body: { name: string, type: string, space_id: integer, divide__dir?: null, filters__op?: string, divide__field?: null, grouping__dir?: integer, columns__fields?: string[], filters__fields?: string[], filters__search?: string, grouping__field?: string, sorting__fields?: string[], grouping__ignore?: boolean, divide__collapsed?: boolean, grouping__collapsed?: string[], filters__show__closed?: boolean, settings__me__comments?: boolean, settings__me__subtasks?: boolean, settings__show__images?: boolean, settings__me__checklists?: boolean, settings__show__subtasks?: integer, team__sidebar__assignees?: string[], settings__show__assignees?: boolean, settings__show__task__locations?: boolean, settings__show__closed__subtasks?: boolean, team__sidebar__unassigned__tasks?: boolean, team__sidebar__assigned__comments?: boolean, settings__collapse__empty__columns?: string, settings__show__subtask__parent__names?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/task` — Creates a new clickup task in a specific list, optionally as a subtask if a `parent` task id (which cannot be a subtask itself and must be in the same list) is provided.
  - body: { name: string, tags?: string[], parent?: string, status?: string, list_id: integer, team_id?: integer, due_date?: integer, links_to?: string, priority?: integer, assignees?: integer[], notify_all?: boolean, start_date?: integer, description?: string, custom_fields?: object[], due_date_time?: boolean, time_estimate?: integer, custom_item_id?: integer, custom_task_ids?: boolean, start_date_time?: boolean, check_required_custom_fields?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/task/attachment` — Uploads a file as an attachment to a specified clickup task, requiring `multipart/form-data` for file upload.
  - body: { task_id: string, team_id?: integer, attachment?: string[], custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/task/comment` — Adds a comment to a clickup task; `team id` is required if `custom task ids` is true.
  - body: { task_id: string, team_id?: integer, assignee: integer, notify_all: boolean, comment_text: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/create/task/from/template` — Creates a new task in a specified clickup list from a task template, using the provided name for the new task.
  - body: { name: string, list_id: integer, template_id: string }
- `POST https://api.mcp.ai/api/clickup/create/team` — Creates a new team (user group) with specified members in a workspace; member ids must be for existing users, and be aware that adding view-only guests as paid members may incur extra charges.
  - body: { name: string, members: integer[], team_id: integer }
- `POST https://api.mcp.ai/api/clickup/create/webhook` — Creates a clickup webhook for a team (workspace) to notify a public url on specified events (at least one, or '*' for all), optionally scoped to a space, folder, list, or task; the endpoint must accep
  - body: { events: string[], list_id?: integer, task_id?: string, team_id: integer, endpoint: string, space_id?: integer, folder_id?: integer }
- `POST https://api.mcp.ai/api/clickup/create/workspace/everything/level/view` — Creates a new, customizable view (e.g., list, board) at the 'everything' level for a specified team (workspace id), encompassing all tasks within that workspace.
  - body: { name: string, type: string, team_id: integer, divide__dir?: null, filters__op?: string, divide__field?: null, grouping__dir?: integer, columns__fields?: string[], filters__fields?: string[], filters__search?: string, grouping__field?: string, sorting__fields?: string[], grouping__ignore?: boolean, divide__collapsed?: boolean, grouping__collapsed?: string[], filters__show__closed?: boolean, settings__me__comments?: boolean, settings__me__subtasks?: boolean, settings__show__images?: boolean, settings__me__checklists?: boolean, settings__show__subtasks?: integer, team__sidebar__assignees?: string[], settings__show__assignees?: boolean, settings__show__task__locations?: boolean, settings__show__closed__subtasks?: boolean, team__sidebar__unassigned__tasks?: boolean, team__sidebar__assigned__comments?: boolean, settings__collapse__empty__columns?: string, settings__show__subtask__parent__names?: boolean }
- `POST https://api.mcp.ai/api/clickup/delete/a/time/entry` — Deletes an existing time entry, specified by `timer id`, from a workspace identified by `team id`.
  - body: { team_id: integer, timer_id: integer }
- `POST https://api.mcp.ai/api/clickup/delete/checklist` — Permanently deletes an existing checklist identified by its `checklist id`.
  - body: { checklist_id: string }
- `POST https://api.mcp.ai/api/clickup/delete/checklist/item` — Permanently deletes an existing item, identified by `checklist item id`, from an existing checklist, identified by `checklist id`.
  - body: { checklist_id: string, checklist_item_id: string }
- `POST https://api.mcp.ai/api/clickup/delete/comment` — Deletes an existing comment from a task using its `comment id`.
  - body: { comment_id: integer }
- `POST https://api.mcp.ai/api/clickup/delete/dependency` — Removes two dependency links for `task id`: one where `task id` is blocked by `depends on`, and another where `dependency of` is blocked by `task id`; `team id` is required if `custom task ids` is tru
  - body: { task_id: string, team_id?: integer, depends_on: string, dependency_of: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/delete/folder` — Permanently and irreversibly deletes a specified folder and all its contents (lists, tasks) if the folder id exists.
  - body: { folder_id: integer }
- `POST https://api.mcp.ai/api/clickup/delete/goal` — Permanently removes an existing goal, identified by its `goal id`, from the workspace.
  - body: { goal_id: string }
- `POST https://api.mcp.ai/api/clickup/delete/key/result` — Deletes an existing key result, also referred to as a target within a goal, identified by its `key result id`.
  - body: { key_result_id: string }
- `POST https://api.mcp.ai/api/clickup/delete/list` — Permanently deletes an existing list and all its contents; this action is destructive and irreversible via the api.
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/clickup/delete/space` — Permanently deletes a specified space in clickup; this action is irreversible as the space cannot be recovered via the api.
  - body: { space_id: integer }
- `POST https://api.mcp.ai/api/clickup/delete/space/tag` — Deletes a tag from a space, identified by `tag name` in path; precise matching of tag details in the request body (`tag name 1`, `tag tag fg`, `tag tag bg`) is generally required for successful deleti
  - body: { space_id: integer, tag_name: string, tag__name?: string, tag__tag__bg?: string, tag__tag__fg?: string }
- `POST https://api.mcp.ai/api/clickup/delete/task` — Permanently deletes a task, using its standard id or a custom task id (requires `custom task ids=true` and `team id`).
  - body: { task_id: string, team_id?: integer, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/delete/task/link` — Deletes an existing link, effectively a dependency or relationship, between two clickup tasks; set `custom task ids=true` and provide `team id` if using custom task ids.
  - body: { task_id: string, team_id?: integer, links_to: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/delete/team` — Permanently deletes an existing team (user group) from the workspace using its `group id`.
  - body: { group_id: string }
- `POST https://api.mcp.ai/api/clickup/delete/time/tracked` — Deletes a time-tracked interval from a task; use this legacy endpoint for older time tracking systems.
  - body: { task_id: string, team_id?: integer, interval_id: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/delete/view` — Permanently and irreversibly deletes an existing view in clickup, identified by its `view id`.
  - body: { view_id: string }
- `POST https://api.mcp.ai/api/clickup/delete/webhook` — Permanently removes an existing webhook, specified by its id, thereby ceasing all its event monitoring and notifications.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/clickup/edit/checklist` — Updates an existing checklist's name or position, identified by its `checklist id`.
  - body: { name?: string, position?: integer, checklist_id: string }
- `POST https://api.mcp.ai/api/clickup/edit/checklist/item` — Updates an existing checklist item, allowing modification of its name, assignee, resolution status, or parent item for nesting.
  - body: { name?: string, parent?: string, assignee?: string, resolved?: boolean, checklist_id: string, checklist_item_id: string }
- `POST https://api.mcp.ai/api/clickup/edit/guest/on/workspace` — Modifies the details and permissions of an existing guest user within a specific workspace.
  - body: { team_id: integer, guest_id: integer, username: string, can_edit_tags: boolean, custom_role_id: integer, can_create_views: boolean, can_see_time_spent: boolean, can_see_time_estimated: boolean }
- `POST https://api.mcp.ai/api/clickup/edit/key/result` — Updates an existing key result's progress or note in clickup, where the key result measures progress towards a goal.
  - body: { note: string, key_result_id: string, steps_current: integer }
- `POST https://api.mcp.ai/api/clickup/edit/space/tag` — Updates an existing tag's name and colors in a clickup space; requires current tag name for identification, and new values for tag name, foreground color, and background color, all of which are mandat
  - body: { space_id: integer, tag_name: string, tag__name?: string, tag__bg__color?: string, tag__fg__color?: string }
- `POST https://api.mcp.ai/api/clickup/edit/time/tracked` — Edits a legacy time-tracked interval for a task (identified by `task id` and `interval id`) to update its start/end times and duration; `team id` is required if `custom task ids` is true.
  - body: { end: integer, time: integer, start: integer, task_id: string, team_id?: integer, interval_id: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/edit/user/on/workspace` — Updates a user's username, admin status, or custom role in a workspace; requires the workspace to be on an enterprise plan.
  - body: { admin: boolean, team_id: integer, user_id: integer, username: string, custom_role_id: integer }
- `POST https://api.mcp.ai/api/clickup/folders/create/new/folder` — Deprecated: creates a new folder in a clickup space; use `create folder` instead.
  - body: { name: string, space_id: integer }
- `POST https://api.mcp.ai/api/clickup/folders/get/contents/of` — Deprecated: use `get folders`. retrieves folders within a specified clickup space, ensuring `space id` is valid, with an option to filter by archived status.
  - body: { archived?: boolean, space_id: integer }
- `POST https://api.mcp.ai/api/clickup/folders/get/folder/content` — Deprecated: retrieves detailed information about a specific folder in clickup; use `get folder` instead.
  - body: { folder_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/access/token` — Exchanges a clickup oauth 2.0 authorization code (obtained after user consent) for an access token.
  - body: { code: string, client_id: string, client_secret: string }
- `POST https://api.mcp.ai/api/clickup/get/accessible/custom/fields` — Retrieves all accessible custom field definitions for a specified clickup list using its `list id`.
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/all/tags/from/time/entries` — Retrieves all unique tags applied to time entries within a specified clickup team (workspace).
  - body: { team_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/authorized/teams/workspaces` — Retrieves a list of workspaces (teams) the authenticated user can access.
- `POST https://api.mcp.ai/api/clickup/get/authorized/user` — Retrieves the details of the currently authenticated clickup user.
- `POST https://api.mcp.ai/api/clickup/get/bulk/tasks/time/in/status` — Retrieves the time spent in each status for multiple tasks; requires the 'total time in status' clickapp to be enabled in the workspace.
  - body: { team_id?: integer, task_ids: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/chat/view/comments` — Retrieves comments from a specified chat view in clickup, supporting pagination via `start` and `start id` to fetch comments older than the default 25 most recent.
  - body: { start?: integer, view_id: string, start_id?: string }
- `POST https://api.mcp.ai/api/clickup/get/custom/roles` — Retrieves all custom roles, which allow granular permission configurations, for a specified workspace (team).
  - body: { team_id: integer, include_members?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/custom/task/types` — Retrieves all custom task types available within a specified workspace (team id).
  - body: { team_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/filtered/team/tasks` — Retrieves a paginated list of tasks (up to 100 per page) from a specified team (workspace id in `team id`) based on various filter criteria, respecting user access permissions.
  - body: { page?: integer, tags?: string[], parent?: string, reverse?: boolean, team_Id: string, team_id?: integer, list_ids?: string[], order_by?: string, statuses?: string[], subtasks?: boolean, assignees?: string[], space_ids?: string[], due_date_gt?: integer, due_date_lt?: integer, project_ids?: string[], custom_items?: integer[], date_done_gt?: integer, date_done_lt?: integer, custom_fields?: string[], include_closed?: boolean, custom_task_ids?: boolean, date_created_gt?: integer, date_created_lt?: integer, date_updated_gt?: integer, date_updated_lt?: integer, include_markdown_description?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/folder` — Retrieves detailed information about a specific folder in clickup.
  - body: { folder_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/folder/views` — Retrieves all configured views (like list, board, calendar) for a specified, existing folder in clickup.
  - body: { folder_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/folderless/lists` — Retrieves all lists within a specified space that are not located in any folder.
  - body: { archived?: boolean, space_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/folders` — Retrieves folders within a specified clickup space, ensuring `space id` is valid, with an option to filter by archived status.
  - body: { archived?: boolean, space_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/goal` — Retrieves detailed information for an existing clickup goal, specified by its unique `goal id`.
  - body: { goal_id: string }
- `POST https://api.mcp.ai/api/clickup/get/goals` — Retrieves goals for a specified clickup workspace (team); the `team id` must be valid and accessible.
  - body: { team_id: integer, include_completed?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/guest` — Call this to retrieve detailed information for a specific guest within a team (workspace), ensuring the `guest id` is valid for the given `team id`; this action requires the clickup enterprise plan.
  - body: { team_id: integer, guest_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/list` — Retrieves detailed information for an existing list in clickup, identified by its unique `list id`.
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/list/comments` — Retrieves comments for a specific clickup list, supporting pagination using `start` (timestamp) and `start id` (comment id) to fetch earlier comments; omits them for the latest 25.
  - body: { start?: integer, list_id: integer, start_id?: string }
- `POST https://api.mcp.ai/api/clickup/get/list/members` — Retrieves all members of a specific, existing clickup list by its id.
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/list/views` — Retrieves all task and page views for a specified and accessible clickup list.
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/lists` — Retrieves all lists within a specified, existing clickup folder, optionally filtering by archived status.
  - body: { archived?: boolean, folder_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/running/time/entry` — Retrieves the currently active time entry for a user in a workspace; a negative 'duration' in its data indicates it's running, and the response may be empty if no entry is active.
  - body: { team_id: integer, assignee?: integer }
- `POST https://api.mcp.ai/api/clickup/get/singular/time/entry` — Fetches a specific time entry by its id for a given team; a negative duration in the response indicates an active timer.
  - body: { team_id: integer, timer_id: string, include__task?: boolean, include_location_names?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/space` — Retrieves detailed information for an existing space in a clickup workspace, identified by its unique space id.
  - body: { space_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/space/tags` — Retrieves all tags for tasks within a specified clickup space, requiring a valid `space id`.
  - body: { space_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/space/views` — Retrieves all task and page views for a specified space id in clickup.
  - body: { space_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/spaces` — Retrieves spaces for a team id; member information for private spaces is returned only if the authenticated user is a member.
  - body: { team_id: integer, archived?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/task` — Retrieves comprehensive details for a clickup task by its id, supporting standard or custom task ids (requires `team id` for custom ids).
  - body: { task_id: string, team_id?: integer, custom_task_ids?: boolean, include_subtasks?: boolean, include_markdown_description?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/task/comments` — Retrieves up to 25 comments for a specified task, supporting pagination using `start` and `start id` to fetch older comments.
  - body: { start?: integer, task_id: string, team_id?: integer, start_id?: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/task/members` — Retrieves users with explicit access (directly assigned or shared) to a specific existing task, excluding users with inherited permissions.
  - body: { task_id: string }
- `POST https://api.mcp.ai/api/clickup/get/task/s/time/in/status` — Retrieves the duration a task has spent in each status, provided the 'total time in status' clickapp is enabled for the workspace.
  - body: { task_id: string, team_id?: integer, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/task/templates` — Retrieves task templates for a specified workspace (team id), supporting pagination.
  - body: { page: integer, team_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/tasks` — Retrieves tasks from a specified clickup list; only tasks whose home is the given list id are returned.
  - body: { page?: integer, tags?: string[], list_id: integer, reverse?: boolean, archived?: boolean, order_by?: string, statuses?: string[], subtasks?: boolean, assignees?: string[], due_date_gt?: integer, due_date_lt?: integer, custom_items?: integer[], date_done_gt?: integer, date_done_lt?: integer, custom_fields?: string[], include_closed?: boolean, date_created_gt?: integer, date_created_lt?: integer, date_updated_gt?: integer, date_updated_lt?: integer, include_markdown_description?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/teams` — Retrieves user groups (teams) from a clickup workspace, typically requiring `team id` (workspace id), with an option to filter by `group ids`.
  - body: { team_id?: integer, group_ids?: string }
- `POST https://api.mcp.ai/api/clickup/get/time/entries/within/a/date/range` — Retrieves time entries for a specified team (workspace id) within a date range (defaults to the last 30 days for the authenticated user if dates are omitted); active timers are indicated by negative d
  - body: { list_id?: integer, task_id?: string, team_Id: integer, team_id?: integer, assignee?: string, end_date?: integer, space_id?: integer, folder_id?: integer, start_date?: integer, custom_task_ids?: boolean, include_task_tags?: boolean, include_location_names?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/time/entry/history` — Retrieves the modification history for an existing time entry within a specific clickup team (workspace).
  - body: { team_id: integer, timer_id: string }
- `POST https://api.mcp.ai/api/clickup/get/tracked/time` — Retrieves tracked time for a task using a legacy endpoint; prefer newer time tracking api endpoints for managing time entries.
  - body: { task_id: string, team_id?: integer, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/get/user` — Retrieves detailed information for a specific user within a clickup workspace (team), available only for workspaces on the clickup enterprise plan.
  - body: { team_id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/view` — Fetches details for a specific clickup view, identified by its `view id`, which must exist.
  - body: { view_id: string }
- `POST https://api.mcp.ai/api/clickup/get/view/tasks` — Retrieves all tasks visible in a specified clickup view, respecting its applied filters, sorting, and grouping.
  - body: { page: integer, view_id: string }
- `POST https://api.mcp.ai/api/clickup/get/webhooks` — Fetches webhooks for a team (workspace), returning only those created by the authenticated user via api, for a `team id` they can access.
  - body: { team_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/workspace/everything/level/views` — Retrieves all task and page views at the 'everything level' (a comprehensive overview of all tasks across all spaces) for a specified clickup workspace.
  - body: { team_id: integer }
- `POST https://api.mcp.ai/api/clickup/get/workspace/plan` — Retrieves the details of the current subscription plan for a specified clickup workspace.
  - body: { team_id: string }
- `POST https://api.mcp.ai/api/clickup/get/workspace/seats` — Retrieves seat utilization (used, total, available for members/guests) for a clickup workspace (team) id, which must be for an existing workspace.
  - body: { team_id: string }
- `POST https://api.mcp.ai/api/clickup/invite/guest/to/workspace` — Invites a guest by email to a clickup workspace (team) on an enterprise plan, setting initial permissions and optionally a custom role; further access configuration for specific items may require sepa
  - body: { email: string, team_id: integer, can_edit_tags: boolean, custom_role_id: integer, can_create_views: boolean, can_see_time_spent: boolean, can_see_time_estimated: boolean }
- `POST https://api.mcp.ai/api/clickup/invite/user/to/workspace` — Invites a user via email to a clickup workspace (team), optionally granting admin rights or a custom role; requires an enterprise plan for the workspace.
  - body: { admin: boolean, email: string, team_id: integer, custom_role_id?: integer }
- `POST https://api.mcp.ai/api/clickup/lists/get/folder/lists` — Deprecated: use `get lists` instead. retrieves lists from a specified, existing clickup folder.
  - body: { archived?: boolean, folder_id: integer }
- `POST https://api.mcp.ai/api/clickup/members/get/list/users` — Deprecated: retrieves users with access to a specific list; use `get list members` instead.
  - body: { list_id: integer }
- `POST https://api.mcp.ai/api/clickup/remove/custom/field/value` — Removes an existing value from a custom field on a specific task; this does not delete the custom field definition or its predefined options.
  - body: { task_id: string, team_id?: integer, field_id: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/remove/guest/from/folder` — Revokes a guest's access to a specific clickup folder, optionally unsharing items explicitly shared with them within it; requires an enterprise plan.
  - body: { guest_id: integer, folder_id: integer, include_shared?: boolean }
- `POST https://api.mcp.ai/api/clickup/remove/guest/from/list` — Revokes a guest's access to a specific list, provided the guest currently has access to this list and the workspace is on the clickup enterprise plan.
  - body: { list_id: integer, guest_id: integer, include_shared?: boolean }
- `POST https://api.mcp.ai/api/clickup/remove/guest/from/task` — Revokes a guest's access to a specific task; only available for workspaces on the clickup enterprise plan.
  - body: { task_id: string, team_id?: integer, guest_id: integer, include_shared?: boolean, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/remove/guest/from/workspace` — Permanently removes a guest from a specified workspace, revoking all their access; this destructive operation requires the workspace to be on the clickup enterprise plan.
  - body: { team_id: integer, guest_id: integer }
- `POST https://api.mcp.ai/api/clickup/remove/tag/from/task` — Removes a tag from a specified task by disassociating it (does not delete the tag from workspace), succeeding even if the tag is not on the task.
  - body: { task_id: string, team_id?: integer, tag_name: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/remove/tags/from/time/entries` — Removes tags from specified time entries in a team, without deleting the tags from the workspace.
  - body: { tags: object[], team_id: integer, time_entry_ids: string[] }
- `POST https://api.mcp.ai/api/clickup/remove/task/from/list` — Removes a task from an extra list (not its home list); the 'tasks in multiple lists' clickapp must be enabled.
  - body: { list_id: integer, task_id: string }
- `POST https://api.mcp.ai/api/clickup/remove/user/from/workspace` — Deactivates a user from a specified clickup workspace, revoking their access (user can be reactivated later); requires the workspace to be on an enterprise plan.
  - body: { team_id: integer, user_id: integer }
- `POST https://api.mcp.ai/api/clickup/set/custom/field/value` — Sets or updates a custom field's value for a task; the new value (with type-dependent structure, e.g., `{"value": "text"}` or `{"value": 123, "value options": {"currency type":"usd"}}`) is provided in
  - body: { task_id: string, team_id?: integer, field_id: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/shared/hierarchy` — Retrieves the hierarchy of tasks, lists, and folders shared with the authenticated user within an existing clickup team (workspace), identified by its `team id`.
  - body: { team_id: integer }
- `POST https://api.mcp.ai/api/clickup/spaces/get/details` — Deprecated: retrieves detailed information about a specific space; use the getspace action instead.
  - body: { space_id: integer }
- `POST https://api.mcp.ai/api/clickup/spaces/get/space/details` — Deprecated: use `get spaces` instead; retrieves spaces, with member info for private spaces accessible only if the user is a member.
  - body: { team_id: integer, archived?: boolean }
- `POST https://api.mcp.ai/api/clickup/start/a/time/entry` — Starts a new time entry (timer) in the specified team (workspace), optionally associating it with a task, adding a description, setting billable status, or applying tags (tags feature requires busines
  - body: { tid?: string, tags?: object[], team_Id: integer, team_id?: integer, billable?: boolean, description?: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/stop/a/time/entry` — Stops the authenticated user's currently active time entry in the specified team (workspace), which requires an existing time entry to be running.
  - body: { team_id: integer }
- `POST https://api.mcp.ai/api/clickup/task/checklists/create/new/checklist` — (deprecated: use `create checklist` instead) creates a new checklist with a specified name within an existing task, identifiable by standard id or custom task id (if `custom task ids` is true, `team i
  - body: { name: string, task_id: string, team_id?: integer, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/tasks/get/task/details` — Retrieves details for a task by its id, supporting standard or custom ids (requires `team id` for custom ids). <<deprecated: this action is deprecated. please use 'get task' instead.>>
  - body: { task_id: string, team_id?: integer, custom_task_ids?: boolean, include_subtasks?: boolean, include_markdown_description?: boolean }
- `POST https://api.mcp.ai/api/clickup/teams/user/groups/create/team` — Deprecated: use 'create team'. creates a team (user group) in a workspace; adding a view-only guest as a paid member may incur extra charges.
  - body: { name: string, members: integer[], team_id: integer }
- `POST https://api.mcp.ai/api/clickup/teams/work/spaces/get/work/space/plan` — Deprecated: retrieves the current plan for the specified workspace; use `get workspace plan` instead.
  - body: { team_id: string }
- `POST https://api.mcp.ai/api/clickup/teams/work/spaces/get/work/space/seats` — Deprecated: use `get workspace seats` to retrieve seat utilization for a clickup workspace (team) id.
  - body: { team_id: string }
- `POST https://api.mcp.ai/api/clickup/track/time` — Records a time entry for a task using clickup's legacy time tracking system; newer endpoints are generally recommended.
  - body: { end: integer, time: integer, start: integer, task_id: string, team_id?: integer, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/update/a/time/entry` — Updates an existing clickup time entry; provide `start` and `end` times together, and include `team id` as a query param (request field `team id 1`) if `custom task ids` is true.
  - body: { end?: integer, tid?: string, tags: object[], start?: integer, team_id: integer, billable?: boolean, duration?: integer, timer_id: integer, tag_action?: string, description?: string, custom_task_ids?: boolean }
- `POST https://api.mcp.ai/api/clickup/update/comment` — Updates an existing task comment's text, assignee (who must be a valid workspace member), or resolution status, requiring a valid existing comment id.
  - body: { assignee: integer, resolved: boolean, comment_id: integer, comment_text: string }
- `POST https://api.mcp.ai/api/clickup/update/folder` — Updates the name of an existing folder in clickup.
  - body: { name: string, folder_id: integer }
- `POST https://api.mcp.ai/api/clickup/update/goal` — Updates attributes of an existing clickup goal, identified by its `goal id`.
  - body: { name: string, color: string, goal_id: string, due_date: integer, add_owners: integer[], rem_owners: integer[], description: string }
- `POST https://api.mcp.ai/api/clickup/update/list` — Updates attributes of an existing clickup list, such as its name, content, due date, priority, assignee, or color status, identified by its `list id`.
  - body: { name: string, status: string, content: string, list_id: string, assignee: string, due_date: integer, priority: integer, unset_status: boolean, due_date_time: boolean }
- `POST https://api.mcp.ai/api/clickup/update/space` — Updates an existing clickup space, allowing modification of its name, color, privacy, and feature settings (clickapps).
  - body: { name: string, color: string, private: boolean, space_id: integer, admin_can_manage: boolean, multiple_assignees: boolean, features__tags__enabled?: boolean, features__checklists__enabled?: boolean, features__due__dates__enabled?: boolean, features__portfolios__enabled?: boolean, features__custom__fields__enabled?: boolean, features__due__dates__start__date?: boolean, features__time__tracking__enabled?: boolean, features__time__estimates__enabled?: boolean, features__dependency__warning__enabled?: boolean, features__remap__dependencies__enabled?: boolean, features__due__dates__remap__due__dates?: boolean, features__due__dates__remap__closed__due__date?: boolean }
- `POST https://api.mcp.ai/api/clickup/update/task` — Updates attributes of an existing task; `team id` is required if `custom task ids` is true, use a single space (" ") for `description` to clear it, and provide at least one modifiable field.
  - body: { name?: string, parent?: string, status?: string, task_id: string, team_id?: integer, archived?: boolean, due_date?: integer, priority?: integer, start_date?: integer, description?: string, due_date_time?: boolean, time_estimate?: integer, assignees__add?: integer[], assignees__rem?: integer[], custom_item_id?: integer, custom_task_ids?: boolean, start_date_time?: boolean }
- `POST https://api.mcp.ai/api/clickup/update/team` — Updates an existing clickup user group (team) using its `group id`; note that adding a view-only guest as a paid member may incur charges.
  - body: { name?: string, handle?: string, group_id: string, members__add?: integer[], members__rem?: integer[] }
- `POST https://api.mcp.ai/api/clickup/update/view` — Updates an existing clickup view's settings such as name, type, grouping, or filters; ensure `parent id` and `parent type` define a valid hierarchy, and that specified field names (e.g. for sorting, c
  - body: { name: string, type: string, view_id: string, parent__id?: string, divide__dir?: null, filters__op?: string, parent__type?: integer, divide__field?: null, grouping__dir?: integer, columns__fields?: string[], filters__fields?: string[], filters__search?: string, grouping__field?: string, sorting__fields?: string[], grouping__ignore?: boolean, divide__collapsed?: boolean, grouping__collapsed?: string[], filters__show__closed?: boolean, settings__me__comments?: boolean, settings__me__subtasks?: boolean, settings__show__images?: boolean, settings__me__checklists?: boolean, settings__show__subtasks?: integer, team__sidebar__assignees?: string[], settings__show__assignees?: boolean, settings__show__task__locations?: boolean, settings__show__closed__subtasks?: boolean, team__sidebar__unassigned__tasks?: boolean, team__sidebar__assigned__comments?: boolean, settings__collapse__empty__columns?: string, settings__show__subtask__parent__names?: boolean }
- `POST https://api.mcp.ai/api/clickup/update/webhook` — Updates the endpoint url, monitored events, and status of an existing webhook, identified by its `webhook id`.
  - body: { events: string, status: string, endpoint: string, webhook_id: string }
- `POST https://api.mcp.ai/api/clickup/views/get/everything/level` — Deprecated: retrieves task and page views at the everything level of a workspace; use `get workspace everything level views` instead.
  - body: { team_id: integer }
- `POST https://api.mcp.ai/api/clickup/views/space/views/get` — (deprecated: use get space views instead) retrieves all task and page views for a specified space id in clickup.
  - body: { space_id: integer }

## More
- Page: https://mcp.ai/clickup
- Agent spec (llms.txt): https://mcp.ai/clickup/llms.txt
- Postman collection: https://mcp.ai/clickup/postman.json