> For the complete documentation index, see [llms.txt](https://notara-1.gitbook.io/notara-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://notara-1.gitbook.io/notara-docs/connectors/clickup.md).

# ClickUp

Read ClickUp tasks, spaces, and workspaces — list what's in progress, get full task details, and search across the workspace — from Slack.

## What It Enables

| Tool              | Capability | Description                                                                |
| ----------------- | ---------- | -------------------------------------------------------------------------- |
| `list_workspaces` | `read`     | List all ClickUp workspaces accessible with the current token              |
| `list_spaces`     | `read`     | List all spaces in a workspace                                             |
| `list_tasks`      | `read`     | List tasks in a list with status, assignees, priority, and due dates       |
| `get_task`        | `read`     | Get full task details including description, subtasks, and recent comments |
| `search_tasks`    | `read`     | Search for tasks across the workspace by keyword                           |

All tools are read-only.

## Setup

**Required:** ClickUp personal API key

**Where to find it:** [app.clickup.com → Settings → Apps](https://app.clickup.com/settings/apps)

1. In the Notara dashboard, go to **Tools**.
2. Click the **ClickUp** tile.
3. In ClickUp, go to **Settings → Apps** and generate a personal API token.
4. Paste the token into the credential field and click **Verify & Save**.

Your API key is encrypted at rest with AES-256-GCM.

## Example Prompts

> "What tasks are overdue in the Sprint 12 list?"

> "Search ClickUp for anything related to the API redesign."

> "Show me the details and comments on task ABC-789."
