ClickUp

Status: in-development. Enable it via AMC_SHOW_CLICKUP=1 env var or the Lab toggle once released; the "ClickUp" sidebar row appears once it is on.

What it is

A first-party AMC integration that connects to your real ClickUp workspace via the ClickUp API v2. It surfaces as a "ClickUp" row in the projects sidebar (purple ListChecks icon) that opens a kanban board view of any ClickUp list.

It is gated through the unreleased-feature registry (clickup), same pattern as Jira board and Pull Requests.

Where to find it

Turn the feature on first, in Settings → Lab → ClickUp. Once it is on, a ClickUp row appears in the projects sidebar (purple checklist icon), and that row is the whole surface — it opens a kanban board for whichever ClickUp list you choose. Connecting happens inside that panel rather than on a Settings page: the connect screen offers Set up ClickUp, which opens a drawer for your ClickUp personal API token, and shows Fix connection if a saved token stops working.

How it behaves

How to use it

1. Enable it: Set AMC_SHOW_CLICKUP=1 or toggle in Settings → Lab → ClickUp.
2. Connect (in-panel): Open the ClickUp sidebar row and click Set up ClickUp on the connect screen, then paste your ClickUp Personal API Token in the drawer and Save (it tests the connection on save). Get a token from ClickUp → Settings → Apps → API Token. If a saved token stops working, the screen shows Fix connection to re-enter it. (ClickUp uses the shared in-app connection stack — the same gear/drawer as the Jira, Linear, and Notion boards — not a separate Settings page.)
3. Once connected, open the ClickUp sidebar row:
   • The sidebar shows your workspaces, spaces, folders, and lists.
   • Select a list to see its tasks as a kanban board grouped by status.
   • Click a task card to open the detail drawer (name, description, priority, due date, assignees, tags, checklists, comments).
   • Add a task from the + Add task row at the bottom of any board column.
   • Use Search to find tasks across your workspace by name.
   • Use My Tasks to see tasks assigned to you.

Working tasks (no browser needed):

• Create a task in any column (seeded with that column's status).
• Edit a task's name, description, priority, due date, and assignees in the drawer; move its status by dragging on the board.
• Delete a task (confirmed).
• Comments: add, edit, and delete comments.
• Checklists: tick / untick checklist items.
• Tags, custom fields, and time tracking are read-only in this pass (edit them in ClickUp for now).
• Tasks assigned to you appear in your Inbox (when inbox is enabled).

For agents

CLI routes (for AI agents)

• POST /clickup/update-task-status — { taskId, status } moves a task.
• POST /clickup/create-task — { listId, name, ... } creates a task.
• POST /clickup/update-task — { taskId, name?, description?, status?, priority?, dueDate?, assignees?, tags? } edits a task.
• POST /clickup/delete-task — { taskId } deletes a task.
• POST /clickup/comment — { taskId, text } posts a comment.
• POST /clickup/edit-comment — { commentId, text } edits a comment.
• POST /clickup/delete-comment — { commentId } deletes a comment.
• POST /clickup/update-checklist-item — { checklistId, checklistItemId, resolved?, name? } updates a checklist item.

All are bearer-authenticated via the CLI server token and 404 when the feature is off.

Inbox source

When clickupInboxEnabled is on, tasks assigned to you appear in the unified Inbox. The poller runs every few minutes and pushes INBOX_CLICKUP_UPDATED when changes are detected (diff by updated_at).

Architecture

• Auth: Personal API Token (raw Authorization: <token> header, not OAuth).
• SSRF guard: Fixed host api.clickup.com — all requests validate origin.
• Rate limiting: 4 concurrent requests max, auto-retry on 429 with retry-after / x-ratelimit-reset header respect.
• ClickUp hierarchy: Workspace → Space → Folder → List → Task.
• Workflow trigger: none — ClickUp is not (yet) a workflow-engine trigger source (unlike Jira/Linear/Notion/Monday/Airtable). Only the inbox poller reacts to changes.

Troubleshooting

• "ClickUp not connected" — open the ClickUp board and click Set up ClickUp (or Fix connection if a saved token is unreachable) to enter your API token in the connection drawer.
• Rate limit errors — the queue auto-retries; if persistent, check your ClickUp plan's API quota (100 req/min on most plans).
• Task not showing — ensure the task is in the selected list and not archived.

Related

The other board integrations built the same way — the same in-panel connect drawer and the same kind of sidebar row — are Jira, Linear and Notion. Tasks assigned to you also land in the unified queue described on the Inbox Overview page.