Mattering Automations ClickUp integration

Connect ClickUp to Mattering Automations: tasks, lists, folders, spaces, custom fields, comments, checklists, tags, time tracking, goals, views, and webhooks as workflow steps, authenticated with a ClickUp personal API token.

Get the credential Connect Verify Node reference Troubleshooting

The Mattering Automations ClickUp integration adds 119 ClickUp nodes to your automation canvas, generated from the ClickUp v2 REST surface. They cover the hierarchy (workspaces, spaces, folders, lists), tasks and everything attached to them (comments, checklists, tags, attachments, custom field values, dependencies, links, members), plus time tracking, goals and key results, views, webhook management, custom roles, and the Enterprise guest and member endpoints.

Setup takes a few minutes: generate a personal API token in ClickUp, attach it as a credential in Mattering, and run a read-only node to confirm the connection. This guide walks through each step, then covers using the integration, the full node reference, and the mistakes that actually come up.

Before you start

A ClickUp account with access to the Workspace, spaces, and lists you want to automate. A personal API token carries your own ClickUp permissions, so the connector can reach exactly what you can reach.
A Mattering workspace with access to the Automations app.
For the nodes labelled Enterprise (guests and workspace member management), a ClickUp plan and role that allow those calls.

Create a ClickUp personal API token

Mattering authenticates to ClickUp with a personal API token, or with an OAuth access token if you already have one. The token is generated from your own ClickUp profile settings, not from a workspace admin console.

In ClickUp, click your avatar in the lower left corner and open Settings.

In the sidebar, open Apps.

Under API Token, click Generate (or Regenerate if you already have one) and copy the token. Personal API tokens begin with pk_.

Regenerating the token invalidates the previous one immediately. If an existing connector, script, or integration is using it, that will stop working until you update it with the new value.

The token inherits your ClickUp permissions. If you want automations scoped more tightly than your own account, generate the token from a ClickUp user that only has access to the spaces the automations should touch.

Connect ClickUp to Mattering

In Mattering Automations, open Connectors and click Add Connector.

Choose ClickUp from the list.

Click Create new credential, paste the token into the Token field exactly as ClickUp gave it to you, and save.

Do not type Bearer in front of the token, and do not paste a trailing space. ClickUp expects the raw token in the Authorization header with no prefix, which is unusual, and Mattering sends the stored value unchanged. A prefixed token fails on every node.

The credential is stored encrypted in Google Secret Manager and never appears in workflow logs.

Click Connect. All 119 ClickUp nodes appear in your canvas palette.

ClickUp has no automated auth test, so Test Connection reports that no auth test is available for this connector. Verify with the read-only node in the next section instead.

Verify it works

Open any automation canvas and check the palette: a ClickUp section should list the query and action nodes. Drop ClickUp: Get Authorized User onto the canvas and run a test step. It takes no arguments and is a safe, read-only call, so a successful response returns the ClickUp user your token belongs to. If it returns an authentication error, the credential is wrong, and the usual cause is a Bearer prefix on the token.

Next, run ClickUp: Get Workspaces. It also takes no arguments and returns every Workspace the token can reach, each with its id. That id is the team_id that most workspace-level nodes ask for (filtered task queries, goals, time tracking, views, webhooks, custom roles), so copy it now. From there, ClickUp: Get Spaces takes the team id and returns space ids, ClickUp: Get Folders takes a space id, and ClickUp: Get Lists takes a folder id. Walking down that chain is the reliable way to collect the ids your workflow needs.

Node reference

119 nodes, generated from the connector itself so this reference always matches what ships.

Read and query nodes 40

ClickUp: Get Authorized User

clickup_get_user

Get the user tied to the API token.

ClickUp: Get Custom Roles

clickup_get_custom_roles

List custom roles in a workspace.

ClickUp: Get Filtered Team Tasks

clickup_get_filtered_team_tasks

Query tasks across a whole workspace with filters.

ClickUp: Get Folder

clickup_get_folder

Get a single folder.

ClickUp: Get Folder Views

clickup_get_folder_views

List views in a folder.

ClickUp: Get Folderless Lists

clickup_get_folderless_lists

List folderless lists in a space.

ClickUp: Get Folders

clickup_get_folders

List folders in a space.

ClickUp: Get Goal

clickup_get_goal

Get a single goal.

ClickUp: Get Goals

clickup_get_goals

List goals in a workspace.

ClickUp: Get Guest

clickup_get_guest

Get a guest (Enterprise).

ClickUp: Get List

clickup_get_list

Get a single list.

ClickUp: Get List Comments

clickup_get_list_comments

List comments on a list.

ClickUp: Get List Custom Fields

clickup_get_accessible_custom_fields

List the custom fields available on a list.

ClickUp: Get List Members

clickup_get_list_members

List members with access to a list.

ClickUp: Get List Views

clickup_get_list_views

List views in a list.

ClickUp: Get Lists

clickup_get_lists

List the lists in a folder.

ClickUp: Get Running Timer

clickup_get_running_time_entry

Get the currently running timer.

ClickUp: Get Shared Hierarchy

clickup_get_shared_hierarchy

List items shared with the user that sit outside their hierarchy.

ClickUp: Get Space

clickup_get_space

Get a single space.

ClickUp: Get Space Tags

clickup_get_space_tags

List tags defined in a space.

ClickUp: Get Space Views

clickup_get_space_views

List views in a space.

ClickUp: Get Spaces

clickup_get_spaces

List spaces in a workspace.

ClickUp: Get Task

clickup_get_task

Get a single task.

ClickUp: Get Task Comments

clickup_get_task_comments

List comments on a task.

ClickUp: Get Task Members

clickup_get_task_members

List members with access to a task.

ClickUp: Get Task Templates

clickup_get_task_templates

List task templates in a workspace.

ClickUp: Get Tasks

clickup_get_tasks

Get tasks in a list (filterable, paginated).

ClickUp: Get Threaded Comments

clickup_get_threaded_comments

List replies to a comment.

ClickUp: Get Time Entries

clickup_get_time_entries

List time entries in a workspace (Time Tracking 2.0).

ClickUp: Get Time Entry

clickup_get_time_entry

Get a single time entry.

ClickUp: Get Time Entry History

clickup_get_time_entry_history

Get the change history of a time entry.

ClickUp: Get Time Entry Tags

clickup_get_time_entry_tags

List all tags used on time entries.

ClickUp: Get Tracked Time (legacy)

clickup_get_tracked_time

Get time tracked on a task (legacy endpoint).

ClickUp: Get View

clickup_get_view

Get a single view's settings.

ClickUp: Get View Comments

clickup_get_chat_view_comments

List comments on a Chat view.

ClickUp: Get View Tasks

clickup_get_view_tasks

Get the tasks visible in a view.

ClickUp: Get Webhooks

clickup_get_webhooks

List webhooks for a workspace.

ClickUp: Get Workspace User

clickup_get_user_details

Get a workspace member (Enterprise).

ClickUp: Get Workspace Views

clickup_get_team_views

List everything-level views.

ClickUp: Get Workspaces

clickup_get_teams

List the Workspaces (teams) available to the token.

Action nodes 79

ClickUp: Add Dependency

clickup_add_dependency

Add a task dependency (waiting on / blocking).

ClickUp: Add Guest to Folder

clickup_add_guest_to_folder

Give a guest access to a folder (Enterprise).

ClickUp: Add Guest to List

clickup_add_guest_to_list

Give a guest access to a list (Enterprise).

ClickUp: Add Guest to Task

clickup_add_guest_to_task

Give a guest access to a task (Enterprise).

ClickUp: Add Tag to Task

clickup_add_tag_to_task

Add a tag to a task.

ClickUp: Add Task Link

clickup_add_task_link

Link two tasks.

ClickUp: Add Task to List

clickup_add_task_to_list

Add an existing task to an additional list (multiple-list feature).

ClickUp: Add Time Entry Tags

clickup_add_time_entry_tags

Add tags to time entries.

ClickUp: Change Time Entry Tag Names

clickup_change_time_entry_tag_names

Rename time-entry tags.

ClickUp: Create Checklist

clickup_create_checklist

Add a checklist to a task.

ClickUp: Create Checklist Item

clickup_create_checklist_item

Add an item to a checklist.

ClickUp: Create Folder

clickup_create_folder

Create a folder in a space.

ClickUp: Create Folder View

clickup_create_folder_view

Create a view in a folder.

ClickUp: Create Folderless List

clickup_create_folderless_list

Create a folderless list in a space.

ClickUp: Create Goal

clickup_create_goal

Create a goal.

ClickUp: Create Key Result

clickup_create_key_result

Add a key result (target) to a goal.

ClickUp: Create List

clickup_create_list

Create a list in a folder.

ClickUp: Create List Comment

clickup_create_list_comment

Add a comment to a list.

ClickUp: Create List View

clickup_create_list_view

Create a view in a list.

ClickUp: Create Space

clickup_create_space

Create a space in a workspace.

ClickUp: Create Space Tag

clickup_create_space_tag

Create a tag in a space.

ClickUp: Create Space View

clickup_create_space_view

Create a view in a space.

ClickUp: Create Task

clickup_create_task

Create a task in a list.

ClickUp: Create Task Attachment

clickup_create_task_attachment

Attach a file to a task (multipart upload, see notes).

ClickUp: Create Task Comment

clickup_create_task_comment

Add a comment to a task.

ClickUp: Create Task From Template

clickup_create_task_from_template

Create a task in a list from a task template.

ClickUp: Create Threaded Comment

clickup_create_threaded_comment

Reply to a comment.

ClickUp: Create Time Entry

clickup_create_time_entry

Create a time entry.

ClickUp: Create View Comment

clickup_create_chat_view_comment

Add a comment to a Chat view.

ClickUp: Create Webhook

clickup_create_webhook

Create a webhook.

ClickUp: Create Workspace View

clickup_create_team_view

Create an everything-level view.

ClickUp: Delete Checklist

clickup_delete_checklist

Delete a checklist.

ClickUp: Delete Checklist Item

clickup_delete_checklist_item

Delete a checklist item.

ClickUp: Delete Comment

clickup_delete_comment

Delete a comment.

ClickUp: Delete Dependency

clickup_delete_dependency

Remove a task dependency.

ClickUp: Delete Folder

clickup_delete_folder

Delete a folder.

ClickUp: Delete Goal

clickup_delete_goal

Delete a goal.

ClickUp: Delete Key Result

clickup_delete_key_result

Delete a key result.

ClickUp: Delete List

clickup_delete_list

Delete a list.

ClickUp: Delete Space

clickup_delete_space

Delete a space.

ClickUp: Delete Space Tag

clickup_delete_space_tag

Delete a space tag.

ClickUp: Delete Task

clickup_delete_task

Delete a task.

ClickUp: Delete Task Link

clickup_delete_task_link

Remove a link between two tasks.

ClickUp: Delete Time Entry

clickup_delete_time_entry

Delete a time entry.

ClickUp: Delete Tracked Time (legacy)

clickup_delete_tracked_time

Delete a tracked time interval (legacy).

ClickUp: Delete View

clickup_delete_view

Delete a view.

ClickUp: Delete Webhook

clickup_delete_webhook

Delete a webhook.

ClickUp: Edit Checklist

clickup_edit_checklist

Rename or reorder a checklist.

ClickUp: Edit Checklist Item

clickup_edit_checklist_item

Edit a checklist item.

ClickUp: Edit Guest

clickup_edit_guest

Edit a guest (Enterprise).

ClickUp: Edit Key Result

clickup_edit_key_result

Update a key result's progress.

ClickUp: Edit Space Tag

clickup_edit_space_tag

Edit a space tag.

ClickUp: Edit Tracked Time (legacy)

clickup_edit_tracked_time

Edit a tracked time interval (legacy).

ClickUp: Edit Workspace User

clickup_edit_user

Edit a workspace member (Enterprise).

ClickUp: Invite Guest

clickup_invite_guest

Invite a guest to the workspace (Enterprise).

ClickUp: Invite User to Workspace

clickup_invite_user

Invite a member to the workspace (Enterprise).

ClickUp: Merge Tasks

clickup_merge_tasks

Merge one or more source tasks into a target task.

ClickUp: Remove Custom Field Value

clickup_remove_custom_field_value

Remove a custom field value from a task.

ClickUp: Remove Guest

clickup_remove_guest

Remove a guest (Enterprise).

ClickUp: Remove Guest from Folder

clickup_remove_guest_from_folder

Revoke a guest's folder access (Enterprise).

ClickUp: Remove Guest from List

clickup_remove_guest_from_list

Revoke a guest's list access (Enterprise).

ClickUp: Remove Guest from Task

clickup_remove_guest_from_task

Revoke a guest's task access (Enterprise).

ClickUp: Remove Tag from Task

clickup_remove_tag_from_task

Remove a tag from a task.

ClickUp: Remove Task from List

clickup_remove_task_from_list

Remove a task from an additional list.

ClickUp: Remove Time Entry Tags

clickup_remove_time_entry_tags

Remove tags from time entries.

ClickUp: Remove Workspace User

clickup_remove_user

Remove a workspace member (Enterprise).

ClickUp: Set Custom Field Value

clickup_set_custom_field_value

Set a custom field value on a task.

ClickUp: Start Timer

clickup_start_time_entry

Start a timer.

ClickUp: Stop Timer

clickup_stop_time_entry

Stop the running timer.

ClickUp: Track Time (legacy)

clickup_track_time

Add tracked time to a task (legacy endpoint).

ClickUp: Update Comment

clickup_update_comment

Update a comment.

ClickUp: Update Folder

clickup_update_folder

Rename/update a folder.

ClickUp: Update Goal

clickup_update_goal

Update a goal.

ClickUp: Update List

clickup_update_list

Update a list.

ClickUp: Update Space

clickup_update_space

Update a space.

ClickUp: Update Task

clickup_update_task

Update a task.

ClickUp: Update Time Entry

clickup_update_time_entry

Update a time entry.

ClickUp: Update View

clickup_update_view

Update a view.

ClickUp: Update Webhook

clickup_update_webhook

Update a webhook.

Using the integration

On the automation canvas

ClickUp nodes chain with every other node: an inbound form or email can create a task, an AI step can summarize and prioritize it, a condition can route it to the right list, and a message node can tell the team it landed. All in one run you can watch step by step.

From AI assistants over MCP

Every node speaks MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and Matter can read, create, and update ClickUp work through the same nodes your workflows use, so agent actions leave the same execution trail.

Finding the ids nodes ask for

Nodes take ClickUp ids, not names. Use [[ClickUp: Get Workspaces]], then [[ClickUp: Get Spaces]], [[ClickUp: Get Folders]], and [[ClickUp: Get Lists]] to walk the hierarchy, or [[ClickUp: Get Folderless Lists]] for lists that sit directly in a space. For custom task ids (the short human-readable ones), set [[custom_task_ids]] to true and supply [[team_id]] on the same node.

Working with custom fields

Read [[ClickUp: Get List Custom Fields]] for the list you are writing to. It returns each field's id and type. Pass that id to [[ClickUp: Set Custom Field Value]] with a value shaped for the field type, and use [[ClickUp: Remove Custom Field Value]] to clear one.

Reacting to ClickUp events

The webhook nodes manage subscriptions, they are not triggers by themselves. Add an [[Incoming Webhook]] trigger to your automation, copy its URL, and register it with [[ClickUp: Create Webhook]] for the events you care about. To poll instead, use the [[Scheduled]] trigger with [[ClickUp: Get Filtered Team Tasks]].

Reaching parameters the node does not name

Every ClickUp node has an [[extra_query]] object that is merged into the request querystring. Commonly used filters are typed fields on the node; anything else ClickUp documents for that endpoint goes in extra_query as a key and value.

Troubleshooting

Every ClickUp node returns an authentication error right after connecting

The stored token is not what ClickUp expects. ClickUp reads the Authorization header with no Bearer prefix, and Mattering sends the credential unchanged, so a value like Bearer pk_123 fails everywhere. Edit the credential and store only the token itself, with no prefix, no quotes, and no leading or trailing whitespace. Then rerun ClickUp: Get Authorized User.

A node returns OAUTH_019 or a team not authorized error

The token cannot reach that Workspace. This happens when a team id was copied from a different Workspace, or when an OAuth access token was issued for one Workspace and used against another. Run ClickUp: Get Workspaces to list the Workspaces the token can actually reach, and use one of those ids. If the Workspace you need is missing, the ClickUp account behind the token has not been added to it.

A task or list call returns a not found error even though the item exists

The id is from the wrong level of the hierarchy. Space, folder, and list ids look alike and are easy to swap, and a folderless list will never appear under ClickUp: Get Lists because that node reads lists inside a folder. Rebuild the id chain with Get Workspaces, Get Spaces, Get Folders, and Get Lists (or Get Folderless Lists), and check that the id you pasted came from the matching step.

A short task id from the ClickUp interface does not work

Custom task ids are not the default id format. On any node that offers them, set custom_task_ids to true and also supply team_id, because ClickUp needs both to resolve a custom id. Without them, pass the standard task id instead.

Setting a custom field value is rejected

Field ids are per list, and the value shape depends on the field type. Run ClickUp: Get List Custom Fields against the same list the task lives in, use the id it returns, and match the type: a drop-down takes the option id rather than the option label, a labels field takes an array, and a date field takes a timestamp in milliseconds.

A guest or workspace member node returns a permission error

Those endpoints are Enterprise-only on ClickUp's side and also depend on the role of the account behind the token. The nodes are in the palette for everyone, but the call only succeeds where the plan and role allow it. Check the plan first, then the role, before debugging the payload.

Attaching a file to a task does not work as expected

ClickUp: Create Task Attachment targets ClickUp's attachment endpoint, which expects a multipart form upload, while the node sends a JSON body. It is not the path for pushing raw file bytes through a workflow. To get a file in front of the team, put a link to it in the task description or in a comment with ClickUp: Create Task Comment.

Nodes start failing with HTTP 429 partway through a run

ClickUp is rate limiting the token. The allowance is per token per minute and depends on the workspace plan, so ClickUp's API documentation is the source of truth for current numbers. Spread the work out: query once and loop over the result instead of calling per item, add a delay inside loops, and retry the failed step after a pause.

The ClickUp MCP

What connecting ClickUp unlocks for AI agents and automations, with common uses and FAQs.

More guides

All Automations documentation

Every integration guide, plus how connectors, credentials, and workflows fit together.

ClickUp is a trademark of its respective owner. Mattering uses platform names to identify the services these integrations connect to; no endorsement or affiliation is implied.