Connect ClickUp

ClickUp connects in two separate ways. You can use either or both.

• Workspace sync: ClickUp tasks sync with a Cyborg project as work items. This is a native Cyborg integration, connected once by the workspace. See Sync tasks with Jira, ClickUp or GitHub for the full flow.
• Agent access: an agent can read ClickUp through the Composio toolkit.

Sync ClickUp with a Cyborg project

1. Open Settings → Integrations, find ClickUp, and click Connect (or Manage). The page is titled ClickUp: “Connect and sync your ClickUp tasks with Cyborg.”
2. Under Connect workspace, click Connect and approve access to your ClickUp workspace.
3. The workspace is listed under Connected workspace.
4. Under Link a project (“Sync tasks from a ClickUp List into a Cyborg project.”), walk through the wizard. ClickUp is organized as workspace, space, then List, and you pick a List. The wizard is described in Sync tasks with Jira, ClickUp or GitHub.

Project syncs then shows how many projects are linked, and Live sync shows the sync health and activity.

Let an agent read ClickUp

An agent can look at tasks in your Spaces through the Composio toolkit.

Requirements

• Composio is connected (it brokers the ClickUp sign-in).
• You can sign in to your ClickUp workspace.

Connect your account

1. In Settings → Integrations, click the ClickUp row to open its sheet.
2. Under Your account, click Connect account so the agent acts as you. Admins can instead use Shared account → Connect shared account, which scheduled or unattended runs require.
3. In the ClickUp window, pick the Workspace to authorize and approve.

Grant ClickUp to an agent

1. In the same sheet, under Agents with access, choose Add agent. Alternatively, open the agent’s editor, go to the Tools step, and enable ClickUp under For this agent.
2. Save. The agent gets ClickUp’s read actions (get tasks, list spaces and lists). Create, update and comment are write actions and are not granted yet. See what a grant covers.

Then ask the agent @ops what's in the "Sprint 12" list right now?.

Troubleshooting

• “Team/Space not found” (agent access): you authorized a different ClickUp workspace than the one holding the Space. Reconnect and pick the right workspace.
• Sync shows a failure: see the live sync view in the sync guide for Fix it and Dismiss.
• Permission denied: the connected ClickUp account lacks access to the Space or List.