---
title: ClickUp
summary: Connect a ClickUp account so your AI agents can look up tasks, lists, and folders, create and update tasks, track time, and add comments under permissions you control.
category: integrations
slug: clickup
---

## What ClickUp in Kronos lets your agents do

Once a ClickUp account is connected to Kronos, your agents can — within
the permissions you grant — work with your spaces, folders, lists, and
tasks just like you would in ClickUp:

**Read actions** (available when an agent has "Read only" or higher):

- Browse your spaces, folders, and lists.
- Look up a specific task, or list and filter the tasks in a list,
  folder, or view.
- Read task comments, checklists, and current statuses.
- See task members, assignees, and the tags on a task.
- Check custom fields and the available task types.
- Review tracked time and time entries within a date range.
- Look up goals and their progress.
- Read the connected account's profile and the workspaces it can reach.

**Write actions** (available only when an agent has "Read and write"):

- Create a new task, or create one from a template.
- Update a task's name, description, status, assignees, dates, or
  priority.
- Move or remove a task from a list, and delete a task.
- Add or remove tags on a task, and set custom field values.
- Create folders, lists, and spaces.
- Add comments to tasks and lists, and create or edit checklists and
  checklist items.
- Create and update goals and key results.
- Start, stop, and edit time tracking.
- Invite or remove members and guests on the workspace.

You decide which agent gets which level, and you can switch any
permission off in one click without disconnecting the ClickUp account.

## Connecting ClickUp

A step-by-step walk-through with screenshots is at `/docs/clickup`. The
short version:

1. Open Kronos → **Connect** in the sidebar → **Applications** tab.
2. Click the **ClickUp** card to open the detail dialog. Click the green
   **Connect** button.
3. You land on ClickUp's screen — sign in if needed and pick the
   Workspace you want to give access to.
4. Review and approve the access ClickUp asks for.
5. You're sent back to Kronos at the Already connected tab with the new
   ClickUp entry pre-selected.
6. The connection is now live and ready to assign to an agent.

You can connect more than one ClickUp account; each appears as its own
connection with its own name.

## Telling connections apart

The ClickUp management page shows the connected account right under the
"ClickUp" title. This is how you and Kronos identify which ClickUp
account a connection represents.

If you connect more than one ClickUp account, each appears with its own
identifier. Optionally you can add a short personal note next to it (the
"Your note for this connection" field) — labels like "Agency Workspace"
or "Personal" make it easier to scan a long list. The note is yours
only; agents always identify the account by the underlying identifier +
ID, not by the note.

## Giving an agent access

On the ClickUp management page click **+ Add AI Agent**, pick the agent
from the dropdown, then choose:

- **Off** — the agent cannot touch this ClickUp account.
- **Read only** — the agent can browse spaces, lists, and tasks and read
  comments, but cannot create, update, move, or delete anything.
- **Read and write** — the agent can do all of the above plus create and
  update tasks, add comments, track time, and manage lists and folders.

The same controls are available inside the AI Agent editor — scroll to
the **Connected Apps** section.

## Fine-grained overrides

Inside the permissions modal (the gear icon next to a ClickUp account in
the agent editor or on the ClickUp management page) you'll see the full
list of ClickUp actions grouped by **Read tools** and **Write tools**.
Toggle individual actions on or off to override the preset.

Common combinations:

- **Status-reporter agent**: preset Read only, no overrides. Agent reads
  tasks and summarizes what's in progress but cannot change anything.
- **Task-intake agent**: preset Read only, override `Create task` ON.
  Agent can read your board and file new tasks, but cannot delete or
  reassign existing ones.
- **Safe project manager**: preset Read and write, override `Delete task`
  OFF. Agent can create, update, comment, and track time, but cannot
  delete tasks.
- **Full assistant**: preset Read and write, no overrides.

Click Save to apply. Changes take effect on the next message the agent
processes.

## Multiple ClickUp accounts on the same agent

If an agent has access to two or more ClickUp accounts (e.g. Agency +
Personal), the agent picks which account to use on every action based on
context. When the request is ambiguous ("create a task for the launch"),
the agent will ask which ClickUp account to use.

You can cut ambiguity by turning the agent's access to one of the
accounts off, or by renaming the connections to obviously distinct
labels ("Agency Workspace" vs "Personal").

## When something goes wrong

- **"Needs reconnect"** badge — ClickUp revoked or expired the
  connection. Open `/app/connect`, click ClickUp, walk through Connect
  again. Permissions are preserved.
- **Agent says "I can't create a task"** — that agent's permission preset
  is Off or Read only without the `Create task` override. Open the
  permissions modal and adjust.
- **Agent says the connected app is temporarily unavailable** — ClickUp
  or the connection had a transient hiccup. Ask the user to retry in a
  moment. If it persists, check the ClickUp management page for a
  "Needs reconnect" badge.

## Privacy

Kronos does NOT store the content of your ClickUp tasks. Each time an
agent uses a ClickUp action, it fetches just-in-time from ClickUp through
the connection, uses what it needs to complete the task, and discards
the result. The audit log records that the action happened (which agent,
which action, when, and whether it succeeded), but not the task
contents.

When you disconnect ClickUp or cancel your Kronos subscription, the
connection and all per-agent permissions are deleted immediately.