> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp

> Connect ClickUp to your Macaly account

ClickUp is an all-in-one productivity platform for tasks, docs, goals, and time tracking. Connect your account once and the agent can manage your ClickUp workspace directly, or use it to power dashboards and automations inside your project.

<Callout icon="user">
  Available on all plans
</Callout>

## Why connect ClickUp

* **Turn app activity into tracked work.** When something happens in your project, a form submission, a signup, a support request, have the agent create a ClickUp task automatically so nothing slips through.
* **Show your team's work without opening ClickUp.** Build a dashboard or client portal that pulls tasks from any list or view, grouped and filtered the way you need.
* **Manage tasks without leaving the chat.** Create tasks, update statuses, set priorities and due dates, or start a timer, all from a chat message.

## What you need

* A **ClickUp account**. Create one for free at [clickup.com](https://clickup.com)
* ClickUp Business or Enterprise if you need guest management, custom roles, or certain time-tracking options

## Connect ClickUp to Macaly

<Steps>
  <Step title="Open Settings">
    Go to **Settings → Integrations** in your Macaly workspace.
  </Step>

  <Step title="Connect ClickUp">
    Find the ClickUp card in the list of apps and click the **Connect** button.
  </Step>

  <Step title="Authorize your account">
    A new window opens, where you'll be asked to sign in to ClickUp. Once you approve access, you'll be redirected back to Macaly.
  </Step>
</Steps>

## Use ClickUp from the chat

Once connected, describe what you want and the agent handles the rest.

Turn app activity into a task automatically:

```
When someone submits my contact form, create a task in my
"Leads" list with their name and email, due in 2 days.
```

Manage tasks directly:

```
Create a task in my "Marketing" list called "Launch newsletter",
set it to high priority, due Friday, and assign it to me.
```

```
Start a timer on the "Design review" task and add a comment
that I'm picking it up now.
```

Or build tools on top of your workspace:

```
Build a dashboard that shows all the open tasks from my "Sprint"
list in ClickUp, grouped by status, and refreshes when I reload.
```

## What the agent can do in ClickUp

Create and update tasks, work with spaces, folders, and lists, create and read Docs, track time, add comments, and manage goals. Guest management, custom roles, and some time-tracking options require ClickUp Business or Enterprise.

## Good to know

* **You connect once.** Every project in your workspace reuses the same ClickUp connection.
* **Some features need a paid ClickUp plan.** Managing guests, custom roles, and some time-tracking options require ClickUp Business or Enterprise.
* **Your account, your control.** The agent only acts when you ask it to. You can disconnect ClickUp anytime from **Settings → Integrations**.