# ClickUp — MCP server on 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

By: mcp.ai · official
Page: https://mcp.ai/clickup

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_clickup?ms=1781542140000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/clickup/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/clickup/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/clickup/skill.md
Postman collection (v2.1): https://mcp.ai/clickup/postman.json

## Tools
- clickup_add_dependency(task_id: string, team_id?: integer, depends_on?: string, depedency_of?: string, custom_task_ids?: boolean) — 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
- clickup_add_guest_to_folder(guest_id: integer, folder_id: integer, include_shared?: boolean, permission_level: string) — Adds a guest to a folder with specified permissions; requires a clickup enterprise plan.
- clickup_add_guest_to_list(list_id: integer, guest_id: integer, include_shared?: boolean, permission_level: string) — Shares a clickup list with an existing guest user, granting them specified permissions; requires the workspace to be on the clickup enterprise plan.
- clickup_add_guest_to_task(task_id: string, team_id?: integer, guest_id: integer, include_shared?: boolean, custom_task_ids?: boolean, permission_level: string) — Assigns a guest to a task with specified permissions; requires clickup enterprise plan, and `team id` if `custom task ids` is true.
- clickup_add_tag_to_task(task_id: string, team_id?: integer, tag_name: string, custom_task_ids?: boolean) — Adds an existing tag to a specified task; team id is required if custom task ids is true.
- clickup_add_tags_from_time_entries(tags: object[], team_id: integer, time_entry_ids: string[]) — Associates a list of specified tags with one or more time entries within a given team (workspace).
- clickup_add_task_link(task_id: string, team_id?: integer, links_to: string, custom_task_ids?: boolean) — Links two existing and accessible clickup tasks, identified by `task id` (source) and `links to` (target).
- clickup_add_task_to_list(list_id: integer, task_id: string) — Adds an existing task to an additional clickup list; the "tasks in multiple lists" clickapp must be enabled in the workspace for this.
- clickup_attachments_upload_file_to_task_as_attachment(task_id: string, team_id?: integer, attachment?: string[], custom_task_ids?: boolean) — Deprecated: use `create task attachment` to upload a file to a task; requires `multipart/form-data`.
- clickup_authorization_get_access_token(code: string, client_id: string, client_secret: string) — Deprecated: use `get access token` instead. exchanges a clickup oauth 2.0 authorization code for an access token.
- clickup_authorization_get_work_space_list() — Deprecated: use `get authorized teams workspaces` instead to retrieve workspaces (teams) accessible to the authenticated user.
- clickup_authorization_view_account_details() — Deprecated: use `get authorized user` instead. retrieves details of the authenticated user's clickup account.
- clickup_change_tag_names_from_time_entries(name: string, tag_bg: string, tag_fg: string, team_id: integer, new_name: string) — Updates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team id`.
- clickup_create_a_time_entry(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) — Creates a new time entry for a specified team.
- clickup_create_chat_view_comment(view_id: string, notify_all: boolean, comment_text: string) — Posts a new comment to a specified clickup chat view; the 'view id' must correspond to an existing and accessible chat view.
- clickup_create_checklist(name: string, task_id: string, team_id?: integer, custom_task_ids?: boolean) — 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).
- clickup_create_checklist_item(name?: string, assignee?: integer, checklist_id: string) — Creates a new checklist item within a specified, existing checklist, optionally setting the item's name and assigning it to a user.
- clickup_create_folder(name: string, space_id: integer) — Creates a new clickup folder within the specified space, which must exist and be accessible.
- clickup_create_folder_view(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) — Creates a new, highly customizable view within a specific clickup folder using its `folder id`.
- clickup_create_folderless_list(name: string, status?: string, content?: string, assignee?: integer, due_date?: integer, priority?: integer, space_id: integer, due_date_time?: boolean) — Creates a new folderless list (a list not part of any folder) directly within a specified clickup space.
- clickup_create_goal(name: string, color: string, owners: integer[], team_id: integer, due_date: integer, description: string, multiple_owners: boolean) — Creates a new goal in a clickup team (workspace).
- clickup_create_key_result(name: string, type: string, unit: string, owners: integer[], goal_id: string, list_ids: string[], task_ids: string[], steps_end: integer, steps_start: integer) — Creates a new key result (target) for a specified goal in clickup to define and track measurable objectives towards achieving that goal.
- clickup_create_list(name: string, status?: string, content?: string, assignee?: integer, due_date?: integer, priority?: integer, folder_id: integer, due_date_time?: boolean) — Creates a new list in clickup within a specified, existing folder.
- clickup_create_list_comment(list_id: integer, assignee: integer, notify_all: boolean, comment_text: string) — 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.
- clickup_create_list_view(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) — Creates a new, customizable view (e.g., list, board, calendar) within a specified clickup list, requiring an existing list id accessible by the user.
- clickup_create_space(name: string, color?: string, private?: boolean, team_id: string, features?: object, multiple_assignees?: boolean) — Creates a new space in a clickup team, with customizable name, privacy, color, and feature settings.
- clickup_create_space_tag(space_id: integer, tag__name?: string, tag__tag__bg?: string, tag__tag__fg?: string) — Creates a new tag (name, foreground color, background color) in an existing clickup space.
- clickup_create_space_view(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) — Creates a customizable view (e.g., list, board, gantt) within a specified clickup space, allowing configuration of grouping, sorting, filtering, and display settings.
- clickup_create_task(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) — 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.
- clickup_create_task_attachment(task_id: string, team_id?: integer, attachment?: string[], custom_task_ids?: boolean) — Uploads a file as an attachment to a specified clickup task, requiring `multipart/form-data` for file upload.
- clickup_create_task_comment(task_id: string, team_id?: integer, assignee: integer, notify_all: boolean, comment_text: string, custom_task_ids?: boolean) — Adds a comment to a clickup task; `team id` is required if `custom task ids` is true.
- clickup_create_task_from_template(name: string, list_id: integer, template_id: string) — Creates a new task in a specified clickup list from a task template, using the provided name for the new task.
- clickup_create_team(name: string, members: integer[], team_id: integer) — 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.
- clickup_create_webhook(events: string[], list_id?: integer, task_id?: string, team_id: integer, endpoint: string, space_id?: integer, folder_id?: integer) — 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
- clickup_create_workspace_everything_level_view(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) — 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.
- clickup_delete_a_time_entry(team_id: integer, timer_id: integer) — Deletes an existing time entry, specified by `timer id`, from a workspace identified by `team id`.
- clickup_delete_checklist(checklist_id: string) — Permanently deletes an existing checklist identified by its `checklist id`.
- clickup_delete_checklist_item(checklist_id: string, checklist_item_id: string) — Permanently deletes an existing item, identified by `checklist item id`, from an existing checklist, identified by `checklist id`.
- clickup_delete_comment(comment_id: integer) — Deletes an existing comment from a task using its `comment id`.
- clickup_delete_dependency(task_id: string, team_id?: integer, depends_on: string, dependency_of: string, custom_task_ids?: boolean) — 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
- clickup_delete_folder(folder_id: integer) — Permanently and irreversibly deletes a specified folder and all its contents (lists, tasks) if the folder id exists.
- clickup_delete_goal(goal_id: string) — Permanently removes an existing goal, identified by its `goal id`, from the workspace.
- clickup_delete_key_result(key_result_id: string) — Deletes an existing key result, also referred to as a target within a goal, identified by its `key result id`.
- clickup_delete_list(list_id: integer) — Permanently deletes an existing list and all its contents; this action is destructive and irreversible via the api.
- clickup_delete_space(space_id: integer) — Permanently deletes a specified space in clickup; this action is irreversible as the space cannot be recovered via the api.
- clickup_delete_space_tag(space_id: integer, tag_name: string, tag__name?: string, tag__tag__bg?: string, tag__tag__fg?: string) — 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
- clickup_delete_task(task_id: string, team_id?: integer, custom_task_ids?: boolean) — Permanently deletes a task, using its standard id or a custom task id (requires `custom task ids=true` and `team id`).
- clickup_delete_task_link(task_id: string, team_id?: integer, links_to: string, custom_task_ids?: boolean) — 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.
- clickup_delete_team(group_id: string) — Permanently deletes an existing team (user group) from the workspace using its `group id`.
- clickup_delete_time_tracked(task_id: string, team_id?: integer, interval_id: string, custom_task_ids?: boolean) — Deletes a time-tracked interval from a task; use this legacy endpoint for older time tracking systems.
- clickup_delete_view(view_id: string) — Permanently and irreversibly deletes an existing view in clickup, identified by its `view id`.
- clickup_delete_webhook(webhook_id: string) — Permanently removes an existing webhook, specified by its id, thereby ceasing all its event monitoring and notifications.
- clickup_edit_checklist(name?: string, position?: integer, checklist_id: string) — Updates an existing checklist's name or position, identified by its `checklist id`.
- clickup_edit_checklist_item(name?: string, parent?: string, assignee?: string, resolved?: boolean, checklist_id: string, checklist_item_id: string) — Updates an existing checklist item, allowing modification of its name, assignee, resolution status, or parent item for nesting.
- clickup_edit_guest_on_workspace(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) — Modifies the details and permissions of an existing guest user within a specific workspace.
- clickup_edit_key_result(note: string, key_result_id: string, steps_current: integer) — Updates an existing key result's progress or note in clickup, where the key result measures progress towards a goal.
- clickup_edit_space_tag(space_id: integer, tag_name: string, tag__name?: string, tag__bg__color?: string, tag__fg__color?: string) — 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
- clickup_edit_time_tracked(end: integer, time: integer, start: integer, task_id: string, team_id?: integer, interval_id: string, custom_task_ids?: boolean) — 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.
- clickup_edit_user_on_workspace(admin: boolean, team_id: integer, user_id: integer, username: string, custom_role_id: integer) — Updates a user's username, admin status, or custom role in a workspace; requires the workspace to be on an enterprise plan.
- clickup_folders_create_new_folder(name: string, space_id: integer) — Deprecated: creates a new folder in a clickup space; use `create folder` instead.
- clickup_folders_get_contents_of(archived?: boolean, space_id: integer) — Deprecated: use `get folders`. retrieves folders within a specified clickup space, ensuring `space id` is valid, with an option to filter by archived status.
- clickup_folders_get_folder_content(folder_id: integer) — Deprecated: retrieves detailed information about a specific folder in clickup; use `get folder` instead.
- clickup_get_access_token(code: string, client_id: string, client_secret: string) — Exchanges a clickup oauth 2.0 authorization code (obtained after user consent) for an access token.
- clickup_get_accessible_custom_fields(list_id: integer) — Retrieves all accessible custom field definitions for a specified clickup list using its `list id`.
- clickup_get_all_tags_from_time_entries(team_id: integer) — Retrieves all unique tags applied to time entries within a specified clickup team (workspace).
- clickup_get_authorized_teams_workspaces() — Retrieves a list of workspaces (teams) the authenticated user can access.
- clickup_get_authorized_user() — Retrieves the details of the currently authenticated clickup user.
- clickup_get_bulk_tasks_time_in_status(team_id?: integer, task_ids: string, custom_task_ids?: boolean) — Retrieves the time spent in each status for multiple tasks; requires the 'total time in status' clickapp to be enabled in the workspace.
- clickup_get_chat_view_comments(start?: integer, view_id: string, start_id?: string) — 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.
- clickup_get_custom_roles(team_id: integer, include_members?: boolean) — Retrieves all custom roles, which allow granular permission configurations, for a specified workspace (team).
- clickup_get_custom_task_types(team_id: integer) — Retrieves all custom task types available within a specified workspace (team id).
- clickup_get_filtered_team_tasks(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) — 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.
- clickup_get_folder(folder_id: integer) — Retrieves detailed information about a specific folder in clickup.
- clickup_get_folder_views(folder_id: integer) — Retrieves all configured views (like list, board, calendar) for a specified, existing folder in clickup.
- clickup_get_folderless_lists(archived?: boolean, space_id: integer) — Retrieves all lists within a specified space that are not located in any folder.
- clickup_get_folders(archived?: boolean, space_id: integer) — Retrieves folders within a specified clickup space, ensuring `space id` is valid, with an option to filter by archived status.
- clickup_get_goal(goal_id: string) — Retrieves detailed information for an existing clickup goal, specified by its unique `goal id`.
- clickup_get_goals(team_id: integer, include_completed?: boolean) — Retrieves goals for a specified clickup workspace (team); the `team id` must be valid and accessible.
- clickup_get_guest(team_id: integer, guest_id: integer) — 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.
- clickup_get_list(list_id: integer) — Retrieves detailed information for an existing list in clickup, identified by its unique `list id`.
- clickup_get_list_comments(start?: integer, list_id: integer, start_id?: string) — 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.
- clickup_get_list_members(list_id: integer) — Retrieves all members of a specific, existing clickup list by its id.
- clickup_get_list_views(list_id: integer) — Retrieves all task and page views for a specified and accessible clickup list.
- clickup_get_lists(archived?: boolean, folder_id: integer) — Retrieves all lists within a specified, existing clickup folder, optionally filtering by archived status.
- clickup_get_running_time_entry(team_id: integer, assignee?: integer) — 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.
- clickup_get_singular_time_entry(team_id: integer, timer_id: string, include__task?: boolean, include_location_names?: boolean) — Fetches a specific time entry by its id for a given team; a negative duration in the response indicates an active timer.
- clickup_get_space(space_id: integer) — Retrieves detailed information for an existing space in a clickup workspace, identified by its unique space id.
- clickup_get_space_tags(space_id: integer) — Retrieves all tags for tasks within a specified clickup space, requiring a valid `space id`.
- clickup_get_space_views(space_id: integer) — Retrieves all task and page views for a specified space id in clickup.
- clickup_get_spaces(team_id: integer, archived?: boolean) — Retrieves spaces for a team id; member information for private spaces is returned only if the authenticated user is a member.
- clickup_get_task(task_id: string, team_id?: integer, custom_task_ids?: boolean, include_subtasks?: boolean, include_markdown_description?: boolean) — Retrieves comprehensive details for a clickup task by its id, supporting standard or custom task ids (requires `team id` for custom ids).
- clickup_get_task_comments(start?: integer, task_id: string, team_id?: integer, start_id?: string, custom_task_ids?: boolean) — Retrieves up to 25 comments for a specified task, supporting pagination using `start` and `start id` to fetch older comments.
- clickup_get_task_members(task_id: string) — Retrieves users with explicit access (directly assigned or shared) to a specific existing task, excluding users with inherited permissions.
- clickup_get_task_s_time_in_status(task_id: string, team_id?: integer, custom_task_ids?: boolean) — Retrieves the duration a task has spent in each status, provided the 'total time in status' clickapp is enabled for the workspace.
- clickup_get_task_templates(page: integer, team_id: integer) — Retrieves task templates for a specified workspace (team id), supporting pagination.
- clickup_get_tasks(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) — Retrieves tasks from a specified clickup list; only tasks whose home is the given list id are returned.
- clickup_get_teams(team_id?: integer, group_ids?: string) — Retrieves user groups (teams) from a clickup workspace, typically requiring `team id` (workspace id), with an option to filter by `group ids`.
- clickup_get_time_entries_within_a_date_range(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) — 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
- clickup_get_time_entry_history(team_id: integer, timer_id: string) — Retrieves the modification history for an existing time entry within a specific clickup team (workspace).
- clickup_get_tracked_time(task_id: string, team_id?: integer, custom_task_ids?: boolean) — Retrieves tracked time for a task using a legacy endpoint; prefer newer time tracking api endpoints for managing time entries.
- clickup_get_user(team_id: integer, user_id: integer) — Retrieves detailed information for a specific user within a clickup workspace (team), available only for workspaces on the clickup enterprise plan.
- clickup_get_view(view_id: string) — Fetches details for a specific clickup view, identified by its `view id`, which must exist.
- clickup_get_view_tasks(page: integer, view_id: string) — Retrieves all tasks visible in a specified clickup view, respecting its applied filters, sorting, and grouping.
- clickup_get_webhooks(team_id: integer) — Fetches webhooks for a team (workspace), returning only those created by the authenticated user via api, for a `team id` they can access.
- clickup_get_workspace_everything_level_views(team_id: integer) — Retrieves all task and page views at the 'everything level' (a comprehensive overview of all tasks across all spaces) for a specified clickup workspace.
- clickup_get_workspace_plan(team_id: string) — Retrieves the details of the current subscription plan for a specified clickup workspace.
- clickup_get_workspace_seats(team_id: string) — Retrieves seat utilization (used, total, available for members/guests) for a clickup workspace (team) id, which must be for an existing workspace.
- clickup_invite_guest_to_workspace(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) — 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
- clickup_invite_user_to_workspace(admin: boolean, email: string, team_id: integer, custom_role_id?: integer) — 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.
- clickup_lists_get_folder_lists(archived?: boolean, folder_id: integer) — Deprecated: use `get lists` instead. retrieves lists from a specified, existing clickup folder.
- clickup_members_get_list_users(list_id: integer) — Deprecated: retrieves users with access to a specific list; use `get list members` instead.
- clickup_remove_custom_field_value(task_id: string, team_id?: integer, field_id: string, custom_task_ids?: boolean) — Removes an existing value from a custom field on a specific task; this does not delete the custom field definition or its predefined options.
- clickup_remove_guest_from_folder(guest_id: integer, folder_id: integer, include_shared?: boolean) — Revokes a guest's access to a specific clickup folder, optionally unsharing items explicitly shared with them within it; requires an enterprise plan.
- clickup_remove_guest_from_list(list_id: integer, guest_id: integer, include_shared?: boolean) — 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.
- clickup_remove_guest_from_task(task_id: string, team_id?: integer, guest_id: integer, include_shared?: boolean, custom_task_ids?: boolean) — Revokes a guest's access to a specific task; only available for workspaces on the clickup enterprise plan.
- clickup_remove_guest_from_workspace(team_id: integer, guest_id: integer) — 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.
- clickup_remove_tag_from_task(task_id: string, team_id?: integer, tag_name: string, custom_task_ids?: boolean) — 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.
- clickup_remove_tags_from_time_entries(tags: object[], team_id: integer, time_entry_ids: string[]) — Removes tags from specified time entries in a team, without deleting the tags from the workspace.
- clickup_remove_task_from_list(list_id: integer, task_id: string) — Removes a task from an extra list (not its home list); the 'tasks in multiple lists' clickapp must be enabled.
- clickup_remove_user_from_workspace(team_id: integer, user_id: integer) — 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.
- clickup_set_custom_field_value(task_id: string, team_id?: integer, field_id: string, custom_task_ids?: boolean) — 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
- clickup_shared_hierarchy(team_id: integer) — Retrieves the hierarchy of tasks, lists, and folders shared with the authenticated user within an existing clickup team (workspace), identified by its `team id`.
- clickup_spaces_get_details(space_id: integer) — Deprecated: retrieves detailed information about a specific space; use the getspace action instead.
- clickup_spaces_get_space_details(team_id: integer, archived?: boolean) — Deprecated: use `get spaces` instead; retrieves spaces, with member info for private spaces accessible only if the user is a member.
- clickup_start_a_time_entry(tid?: string, tags?: object[], team_Id: integer, team_id?: integer, billable?: boolean, description?: string, custom_task_ids?: boolean) — 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
- clickup_stop_a_time_entry(team_id: integer) — Stops the authenticated user's currently active time entry in the specified team (workspace), which requires an existing time entry to be running.
- clickup_task_checklists_create_new_checklist(name: string, task_id: string, team_id?: integer, custom_task_ids?: boolean) — (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
- clickup_tasks_get_task_details(task_id: string, team_id?: integer, custom_task_ids?: boolean, include_subtasks?: boolean, include_markdown_description?: boolean) — 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.>>
- clickup_teams_user_groups_create_team(name: string, members: integer[], team_id: integer) — 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.
- clickup_teams_work_spaces_get_work_space_plan(team_id: string) — Deprecated: retrieves the current plan for the specified workspace; use `get workspace plan` instead.
- clickup_teams_work_spaces_get_work_space_seats(team_id: string) — Deprecated: use `get workspace seats` to retrieve seat utilization for a clickup workspace (team) id.
- clickup_track_time(end: integer, time: integer, start: integer, task_id: string, team_id?: integer, custom_task_ids?: boolean) — Records a time entry for a task using clickup's legacy time tracking system; newer endpoints are generally recommended.
- clickup_update_a_time_entry(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) — 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.
- clickup_update_comment(assignee: integer, resolved: boolean, comment_id: integer, comment_text: string) — Updates an existing task comment's text, assignee (who must be a valid workspace member), or resolution status, requiring a valid existing comment id.
- clickup_update_folder(name: string, folder_id: integer) — Updates the name of an existing folder in clickup.
- clickup_update_goal(name: string, color: string, goal_id: string, due_date: integer, add_owners: integer[], rem_owners: integer[], description: string) — Updates attributes of an existing clickup goal, identified by its `goal id`.
- clickup_update_list(name: string, status: string, content: string, list_id: string, assignee: string, due_date: integer, priority: integer, unset_status: boolean, due_date_time: boolean) — Updates attributes of an existing clickup list, such as its name, content, due date, priority, assignee, or color status, identified by its `list id`.
- clickup_update_space(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) — Updates an existing clickup space, allowing modification of its name, color, privacy, and feature settings (clickapps).
- clickup_update_task(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) — 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.
- clickup_update_team(name?: string, handle?: string, group_id: string, members__add?: integer[], members__rem?: integer[]) — 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.
- clickup_update_view(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) — 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
- clickup_update_webhook(events: string, status: string, endpoint: string, webhook_id: string) — Updates the endpoint url, monitored events, and status of an existing webhook, identified by its `webhook id`.
- clickup_views_get_everything_level(team_id: integer) — Deprecated: retrieves task and page views at the everything level of a workspace; use `get workspace everything level views` instead.
- clickup_views_space_views_get(space_id: integer) — (deprecated: use get space views instead) retrieves all task and page views for a specified space id in clickup.

## Links
Docs: https://mcp.ai/docs/mcps/clickup
Website: https://mcp.ai/mcps/clickup