ClickUp MCP server for Claude, ChatGPT, Claude Code and Cursor

Exchanges a clickup oauth 2.0 authorization code (obtained after user consent) for an access token.

Creates a new clickup folder within the specified space, which must exist and be accessible.

Permanently and irreversibly deletes a specified folder and all its contents (lists, tasks) if the folder id exists.

Modifies the details and permissions of an existing guest user within a specific workspace.

Assigns a guest to a task with specified permissions; requires clickup enterprise plan, and `team id` if `custom task ids` is true.

Shares a clickup list with an existing guest user, granting them specified permissions; requires the workspace to be on the clickup enterprise plan.

Adds a guest to a folder with specified permissions; requires a clickup enterprise plan.

Uploads a file as an attachment to a specified clickup task, requiring `multipart/form-data` for file upload.

Adds a comment to a clickup task; `team id` is required if `custom task ids` is true.

Posts a new comment to a specified clickup chat view; the 'view id' must correspond to an existing and accessible chat view.

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.

Deletes an existing comment from a task using its `comment id`.

Creates a new list in clickup within a specified, existing folder.

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.

Permanently deletes a task, using its standard id or a custom task id (requires `custom task ids=true` and `team id`).

Retrieves comprehensive details for a clickup task by its id, supporting standard or custom task ids (requires `team id` for custom ids).

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.

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 `custom task ids` is true.

Associates a list of specified tags with one or more time entries within a given team (workspace).

Adds an existing tag to a specified task; team id is required if custom task ids is true.

Links two existing and accessible clickup tasks, identified by `task id` (source) and `links to` (target).

Adds an existing task to an additional clickup list; the "tasks in multiple lists" clickapp must be enabled in the workspace for this.

Updates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team id`.

Creates a new time entry for a specified team.

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

Creates a new checklist item within a specified, existing checklist, optionally setting the item's name and assigning it to a user.

Creates a new folderless list (a list not part of any folder) directly within a specified clickup space.

Creates a new, highly customizable view within a specific clickup folder using its `folder id`.

Creates a new goal in a clickup team (workspace).

Creates a new key result (target) for a specified goal in clickup to define and track measurable objectives towards achieving that goal.

Creates a new, customizable view (e.g., list, board, calendar) within a specified clickup list, requiring an existing list id accessible by the user.

Creates a new space in a clickup team, with customizable name, privacy, color, and feature settings.

Creates a new tag (name, foreground color, background color) in an existing clickup space.

Creates a customizable view (e.g., list, board, gantt) within a specified clickup space, allowing configuration of grouping, sorting, filtering, and display settings.

Creates a new task in a specified clickup list from a task template, using the provided name for the new task.

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.

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 accept requests from dynamic ips.

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.

Deletes an existing time entry, specified by `timer id`, from a workspace identified by `team id`.

Permanently deletes an existing checklist identified by its `checklist id`.

Permanently deletes an existing item, identified by `checklist item id`, from an existing checklist, identified by `checklist id`.

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

Permanently removes an existing goal, identified by its `goal id`, from the workspace.

Deletes an existing key result, also referred to as a target within a goal, identified by its `key result id`.

Permanently deletes an existing list and all its contents; this action is destructive and irreversible via the api.

Permanently deletes a specified space in clickup; this action is irreversible as the space cannot be recovered via the api.

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

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.

Permanently deletes an existing team (user group) from the workspace using its `group id`.

Deletes a time-tracked interval from a task; use this legacy endpoint for older time tracking systems.

Permanently and irreversibly deletes an existing view in clickup, identified by its `view id`.

Permanently removes an existing webhook, specified by its id, thereby ceasing all its event monitoring and notifications.

Updates an existing checklist's name or position, identified by its `checklist id`.

Updates an existing checklist item, allowing modification of its name, assignee, resolution status, or parent item for nesting.

Updates an existing key result's progress or note in clickup, where the key result measures progress towards a goal.

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 mandatory for the update.

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.

Updates a user's username, admin status, or custom role in a workspace; requires the workspace to be on an enterprise plan.

Retrieves all accessible custom field definitions for a specified clickup list using its `list id`.

Retrieves all unique tags applied to time entries within a specified clickup team (workspace).

Retrieves a list of workspaces (teams) the authenticated user can access.

Retrieves the details of the currently authenticated clickup user.

Retrieves the time spent in each status for multiple tasks; requires the 'total time in status' clickapp to be enabled in the workspace.

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.

Retrieves all custom roles, which allow granular permission configurations, for a specified workspace (team).

Retrieves all custom task types available within a specified workspace (team id).

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.

Retrieves detailed information about a specific folder in clickup.

Retrieves all lists within a specified space that are not located in any folder.

Retrieves folders within a specified clickup space, ensuring `space id` is valid, with an option to filter by archived status.

Retrieves all configured views (like list, board, calendar) for a specified, existing folder in clickup.

Retrieves detailed information for an existing clickup goal, specified by its unique `goal id`.

Retrieves goals for a specified clickup workspace (team); the `team id` must be valid and accessible.

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.

Retrieves detailed information for an existing list in clickup, identified by its unique `list id`.

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.

Retrieves all members of a specific, existing clickup list by its id.

Retrieves all lists within a specified, existing clickup folder, optionally filtering by archived status.

Retrieves all task and page views for a specified and accessible clickup list.

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.

Fetches a specific time entry by its id for a given team; a negative duration in the response indicates an active timer.

Retrieves detailed information for an existing space in a clickup workspace, identified by its unique space id.

Retrieves spaces for a team id; member information for private spaces is returned only if the authenticated user is a member.

Retrieves all tags for tasks within a specified clickup space, requiring a valid `space id`.

Retrieves all task and page views for a specified space id in clickup.

Retrieves up to 25 comments for a specified task, supporting pagination using `start` and `start id` to fetch older comments.

Retrieves users with explicit access (directly assigned or shared) to a specific existing task, excluding users with inherited permissions.

Retrieves tasks from a specified clickup list; only tasks whose home is the given list id are returned.

Retrieves the duration a task has spent in each status, provided the 'total time in status' clickapp is enabled for the workspace.

Retrieves task templates for a specified workspace (team id), supporting pagination.

Retrieves user groups (teams) from a clickup workspace, typically requiring `team id` (workspace id), with an option to filter by `group ids`.

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 durations in the response.

Retrieves the modification history for an existing time entry within a specific clickup team (workspace).

Retrieves tracked time for a task using a legacy endpoint; prefer newer time tracking api endpoints for managing time entries.

Retrieves detailed information for a specific user within a clickup workspace (team), available only for workspaces on the clickup enterprise plan.

Fetches details for a specific clickup view, identified by its `view id`, which must exist.

Retrieves all tasks visible in a specified clickup view, respecting its applied filters, sorting, and grouping.

Fetches webhooks for a team (workspace), returning only those created by the authenticated user via api, for a `team id` they can access.

Retrieves all task and page views at the 'everything level' (a comprehensive overview of all tasks across all spaces) for a specified clickup workspace.

Retrieves the details of the current subscription plan for a specified clickup workspace.