Agent Forge

ClickUp

Manage ClickUp workspaces — tasks, lists, folders, comments, time tracking, webhooks

cl

ClickUp is a project management platform covering tasks, lists, folders, spaces, time tracking, docs, and more.

In Agent Forge, the ClickUp integration lets workflows read and write to your ClickUp workspace — create tasks from form submissions, update statuses based on agent decisions, sync time entries, post comments triggered by other systems, and register webhooks for inbound automation.

This is a bring-your-own-key (BYOK) integration. Each user supplies their own ClickUp personal API token.

Usage Instructions

Generate a personal API token from clickup.com → Settings → Apps → API Token. The token starts with pk_. ClickUp passes the token directly in the Authorization header (no Bearer prefix) — the block handles this for you.

To find IDs (workspace, space, folder, list, task), open the resource in the ClickUp UI — the IDs are visible in the URL.

Tools

Account

  • clickup_get_user - Get the currently authorized user
  • clickup_get_teams - List workspaces the user belongs to
  • clickup_get_team_members - List members of a workspace

Spaces

  • clickup_get_spaces - List spaces in a workspace
  • clickup_get_space - Get a single space by ID

Folders

  • clickup_get_folders - List folders in a space
  • clickup_create_folder - Create a folder

Lists

  • clickup_get_lists - Lists inside a folder
  • clickup_get_folderless_lists - Lists directly in a space (no folder)
  • clickup_get_list - Get a single list
  • clickup_create_list - Create a list inside a folder

Tasks

  • clickup_get_tasks - List tasks in a list (with rich filters: status, tags, assignees, date ranges, etc.)
  • clickup_get_task - Get a single task
  • clickup_create_task - Create a task (supports priority, assignees, tags, parent, custom fields)
  • clickup_update_task - Update fields on a task (status, priority, assignees, dates)
  • clickup_delete_task - Delete a task

Comments

  • clickup_get_task_comments - List comments on a task
  • clickup_create_task_comment - Add a comment to a task

Time tracking

  • clickup_get_time_entries - List time entries for a workspace, filterable by date range, assignee, task, list, folder, or space

Webhooks

  • clickup_get_webhooks - List webhooks on a workspace
  • clickup_create_webhook - Create a webhook
  • clickup_delete_webhook - Delete a webhook by ID

Common Inputs

ParameterTypeRequiredDescription
apiKeystringYesClickUp personal API token (pk_...)
team_idstringWorkspace opsWorkspace (team) ID
space_idstringSpace opsSpace ID
folder_idstringFolder opsFolder ID
list_idstringList opsList ID
task_idstringTask opsTask ID
namestringCreate opsName of the task / list / folder
description / markdown_descriptionstringNoPlain-text or Markdown body
statusstringNoStatus label (must match a status configured in ClickUp)
prioritynumberNo1 (urgent) – 4 (low)
due_date / start_datenumberNoUnix milliseconds
assigneesstringNoComma-separated user IDs
tagsstringNoComma-separated tag names
custom_fieldsstring (JSON)NoJSON object of { field_id: value }
comment_textstringCommentsComment body

Output

ParameterTypeDescription
datajsonClickUp response data

Notes

  • Category: tools
  • Type: clickup
  • BYOK only. The platform does not hold a ClickUp token.
  • The personal API token grants full access to the user's workspaces. Treat it like a password.
  • For high-volume polling, prefer webhooks (clickup_create_webhook) over repeated clickup_get_tasks calls.
  • Custom Task IDs: tasks created with custom IDs (e.g. CU-123) require custom_task_ids: true and the workspace team_id for lookup.