# ClickUp

## Overview

ClickUp integration allows you to manage ClickUp tasks and workflows directly from Suger.

### Org-Level vs User-Level

> **User-Level Only**: ClickUp integration is configured per user. Each user authenticates with their own ClickUp account via OAuth.

## Create Integration

1. Click `Connect Now` button in the User Integrations section
2. You will be redirected to ClickUp to authorize
3. Grant access to your ClickUp workspace
4. Return to Suger to confirm connection

## Suger AI Tools

Suger AI uses a **middleware** strategy — wrapping the ClickUp API directly.

> **User-level only**: ClickUp tools use each user's personal OAuth credentials.

**Workspaces & Spaces**

| Tool | Description |
|------|-------------|
| `clickup_list_workspaces` | List all workspaces (teams) the user belongs to |
| `clickup_list_spaces` | List spaces in a workspace |
| `clickup_list_folders` | List folders in a space |
| `clickup_list_lists` | List lists in a space |
| `clickup_list_folder_lists` | List lists inside a folder |

**Tasks**

| Tool | Description |
|------|-------------|
| `clickup_list_tasks` | List tasks in a list |
| `clickup_list_team_tasks` | List tasks across a workspace with filters |
| `clickup_get_task` | Get a task by ID |
| `clickup_create_task` | Create a new task in a list |
| `clickup_update_task` | Update task fields (name, status, assignees, etc.) |
| `clickup_fetch_attachment` | Fetch a task attachment by URL |

**Comments**

| Tool | Description |
|------|-------------|
| `clickup_create_comment` | Add a comment to a task |
| `clickup_get_comments` | Get all comments on a task |

**User**

| Tool | Description |
|------|-------------|
| `clickup_get_authorized_user` | Get the currently authenticated ClickUp user |

## Edit Integration

Editing is not supported. Delete and recreate.

## Delete Integration

Deleting removes the integration.

:::warning
Deleting the integration will remove access to ClickUp immediately.
:::