The ClickUp MCP that covers the whole v2 API
Connect ClickUp once and your tasks, lists, folders, spaces, custom fields, comments, timers, and goals become building blocks for visual automations and AI agent workflows. 119 typed nodes, one credential, no code.
What the ClickUp MCP connector does
The ClickUp connector for Mattering Automations is our largest connector: 119 nodes generated from the ClickUp v2 REST surface, 40 of them read nodes and 79 of them write nodes. They follow the ClickUp hierarchy you already work in. Workspaces, spaces, folders, lists, and folderless lists for structure. Tasks for the work itself, including single-task reads, list queries, workspace-wide filtered queries, templates, merges, links, dependencies, and the multiple-lists feature. Then the layers that hang off a task: comments and threaded replies, checklists and checklist items, tags, attachments, custom field values, and task members.
Past the task graph, the connector also covers the parts of ClickUp that reporting and operations depend on: Time Tracking 2.0 (entries, running timer, start and stop, history, and time entry tags) alongside the legacy task time endpoints, goals and key results, views at every level of the hierarchy plus the tasks visible in a view, webhook management, custom roles, shared hierarchy, and the Enterprise guest and workspace member endpoints.
Each capability is a node on the Automations canvas, and every node speaks MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and any MCP-capable assistant can use them, and they also power Matter, the platform's built-in AI assistant. Describe the ClickUp workflow you want in plain language and it gets built on the canvas in front of you, where you can see and edit every step.
Every node also accepts an extra_query object that is merged into the request querystring, so any documented ClickUp filter or parameter the node's own fields do not name stays reachable without waiting on a connector update.
One connection, three surfaces
- Visual automations. Drag ClickUp nodes onto the canvas and wire them to triggers, conditions, and other apps.
- AI agents, yours or ours. These nodes speak MCP, the open protocol, so Claude, ChatGPT, and any MCP-capable assistant can use them, and Matter, the agent built into the platform, uses them natively.
- The whole platform. Combine with native tasks, projects, and other connectors, no middleware in between.
Every ClickUp node, ready to drop on the canvas
119 nodes, generated from the connector itself so this list always matches what ships. Expand a category to browse.
Read and query nodes 40
ClickUp: Get Authorized User
Get the user tied to the API token.
ClickUp: Get Custom Roles
List custom roles in a workspace.
ClickUp: Get Filtered Team Tasks
Query tasks across a whole workspace with filters.
ClickUp: Get Folder
Get a single folder.
ClickUp: Get Folder Views
List views in a folder.
ClickUp: Get Folderless Lists
List folderless lists in a space.
ClickUp: Get Folders
List folders in a space.
ClickUp: Get Goal
Get a single goal.
ClickUp: Get Goals
List goals in a workspace.
ClickUp: Get Guest
Get a guest (Enterprise).
ClickUp: Get List
Get a single list.
ClickUp: Get List Comments
List comments on a list.
ClickUp: Get List Custom Fields
List the custom fields available on a list.
ClickUp: Get List Members
List members with access to a list.
ClickUp: Get List Views
List views in a list.
ClickUp: Get Lists
List the lists in a folder.
ClickUp: Get Running Timer
Get the currently running timer.
ClickUp: Get Shared Hierarchy
List items shared with the user that sit outside their hierarchy.
ClickUp: Get Space
Get a single space.
ClickUp: Get Space Tags
List tags defined in a space.
ClickUp: Get Space Views
List views in a space.
ClickUp: Get Spaces
List spaces in a workspace.
ClickUp: Get Task
Get a single task.
ClickUp: Get Task Comments
List comments on a task.
ClickUp: Get Task Members
List members with access to a task.
ClickUp: Get Task Templates
List task templates in a workspace.
ClickUp: Get Tasks
Get tasks in a list (filterable, paginated).
ClickUp: Get Threaded Comments
List replies to a comment.
ClickUp: Get Time Entries
List time entries in a workspace (Time Tracking 2.0).
ClickUp: Get Time Entry
Get a single time entry.
ClickUp: Get Time Entry History
Get the change history of a time entry.
ClickUp: Get Time Entry Tags
List all tags used on time entries.
ClickUp: Get Tracked Time (legacy)
Get time tracked on a task (legacy endpoint).
ClickUp: Get View
Get a single view's settings.
ClickUp: Get View Comments
List comments on a Chat view.
ClickUp: Get View Tasks
Get the tasks visible in a view.
ClickUp: Get Webhooks
List webhooks for a workspace.
ClickUp: Get Workspace User
Get a workspace member (Enterprise).
ClickUp: Get Workspace Views
List everything-level views.
ClickUp: Get Workspaces
List the Workspaces (teams) available to the token.
Action nodes 79
ClickUp: Add Dependency
Add a task dependency (waiting on / blocking).
ClickUp: Add Guest to Folder
Give a guest access to a folder (Enterprise).
ClickUp: Add Guest to List
Give a guest access to a list (Enterprise).
ClickUp: Add Guest to Task
Give a guest access to a task (Enterprise).
ClickUp: Add Tag to Task
Add a tag to a task.
ClickUp: Add Task Link
Link two tasks.
ClickUp: Add Task to List
Add an existing task to an additional list (multiple-list feature).
ClickUp: Add Time Entry Tags
Add tags to time entries.
ClickUp: Change Time Entry Tag Names
Rename time-entry tags.
ClickUp: Create Checklist
Add a checklist to a task.
ClickUp: Create Checklist Item
Add an item to a checklist.
ClickUp: Create Folder
Create a folder in a space.
ClickUp: Create Folder View
Create a view in a folder.
ClickUp: Create Folderless List
Create a folderless list in a space.
ClickUp: Create Goal
Create a goal.
ClickUp: Create Key Result
Add a key result (target) to a goal.
ClickUp: Create List
Create a list in a folder.
ClickUp: Create List Comment
Add a comment to a list.
ClickUp: Create List View
Create a view in a list.
ClickUp: Create Space
Create a space in a workspace.
ClickUp: Create Space Tag
Create a tag in a space.
ClickUp: Create Space View
Create a view in a space.
ClickUp: Create Task
Create a task in a list.
ClickUp: Create Task Attachment
Attach a file to a task (multipart upload, see notes).
ClickUp: Create Task Comment
Add a comment to a task.
ClickUp: Create Task From Template
Create a task in a list from a task template.
ClickUp: Create Threaded Comment
Reply to a comment.
ClickUp: Create Time Entry
Create a time entry.
ClickUp: Create View Comment
Add a comment to a Chat view.
ClickUp: Create Webhook
Create a webhook.
ClickUp: Create Workspace View
Create an everything-level view.
ClickUp: Delete Checklist
Delete a checklist.
ClickUp: Delete Checklist Item
Delete a checklist item.
ClickUp: Delete Comment
Delete a comment.
ClickUp: Delete Dependency
Remove a task dependency.
ClickUp: Delete Folder
Delete a folder.
ClickUp: Delete Goal
Delete a goal.
ClickUp: Delete Key Result
Delete a key result.
ClickUp: Delete List
Delete a list.
ClickUp: Delete Space
Delete a space.
ClickUp: Delete Space Tag
Delete a space tag.
ClickUp: Delete Task
Delete a task.
ClickUp: Delete Task Link
Remove a link between two tasks.
ClickUp: Delete Time Entry
Delete a time entry.
ClickUp: Delete Tracked Time (legacy)
Delete a tracked time interval (legacy).
ClickUp: Delete View
Delete a view.
ClickUp: Delete Webhook
Delete a webhook.
ClickUp: Edit Checklist
Rename or reorder a checklist.
ClickUp: Edit Checklist Item
Edit a checklist item.
ClickUp: Edit Guest
Edit a guest (Enterprise).
ClickUp: Edit Key Result
Update a key result's progress.
ClickUp: Edit Space Tag
Edit a space tag.
ClickUp: Edit Tracked Time (legacy)
Edit a tracked time interval (legacy).
ClickUp: Edit Workspace User
Edit a workspace member (Enterprise).
ClickUp: Invite Guest
Invite a guest to the workspace (Enterprise).
ClickUp: Invite User to Workspace
Invite a member to the workspace (Enterprise).
ClickUp: Merge Tasks
Merge one or more source tasks into a target task.
ClickUp: Remove Custom Field Value
Remove a custom field value from a task.
ClickUp: Remove Guest
Remove a guest (Enterprise).
ClickUp: Remove Guest from Folder
Revoke a guest's folder access (Enterprise).
ClickUp: Remove Guest from List
Revoke a guest's list access (Enterprise).
ClickUp: Remove Guest from Task
Revoke a guest's task access (Enterprise).
ClickUp: Remove Tag from Task
Remove a tag from a task.
ClickUp: Remove Task from List
Remove a task from an additional list.
ClickUp: Remove Time Entry Tags
Remove tags from time entries.
ClickUp: Remove Workspace User
Remove a workspace member (Enterprise).
ClickUp: Set Custom Field Value
Set a custom field value on a task.
ClickUp: Start Timer
Start a timer.
ClickUp: Stop Timer
Stop the running timer.
ClickUp: Track Time (legacy)
Add tracked time to a task (legacy endpoint).
ClickUp: Update Comment
Update a comment.
ClickUp: Update Folder
Rename/update a folder.
ClickUp: Update Goal
Update a goal.
ClickUp: Update List
Update a list.
ClickUp: Update Space
Update a space.
ClickUp: Update Task
Update a task.
ClickUp: Update Time Entry
Update a time entry.
ClickUp: Update View
Update a view.
ClickUp: Update Webhook
Update a webhook.
Connecting ClickUp takes one credential
ClickUp authenticates with a personal API token (or an OAuth access token) sent in the Authorization header. You generate a personal token from your own ClickUp profile settings in a few clicks, and it carries your ClickUp permissions.
In ClickUp, click your avatar, open Settings, then Apps, and generate a personal API token. It begins with pk_. Copy it.
In Mattering Automations, open Connectors, click Add Connector, and choose ClickUp.
Create a new credential and paste the token exactly as ClickUp shows it. Do not type Bearer in front of it: ClickUp expects the raw token in the Authorization header, and Mattering sends it unchanged.
Click Connect. All 119 ClickUp nodes appear in your canvas palette.
Confirm it works by dropping ClickUp: Get Authorized User on the canvas and running a test step. It takes no arguments and returns the ClickUp user the token belongs to.
Common uses for the ClickUp MCP
Task intake from anywhere
Turn a form response, an inbound email, a Slack message, or a webhook into a ClickUp task with the right list, assignees, due date, tags, and custom field values already filled in, so nothing waits on someone retyping it.
Agent-driven triage and updates
Let an agent read a task with ClickUp: Get Task, decide what it is, then update the status, move it between lists, add a dependency, or post a comment. The agent works through the same nodes your workflows use, so its actions are auditable.
Cross-workspace reporting
ClickUp: Get Filtered Team Tasks queries tasks across a whole workspace with filters, and ClickUp: Get View Tasks reads whatever a saved view shows. Pair either with goals and time entries to build a weekly rollup and send it wherever your team reads it.
Custom fields as the automation contract
Read the fields defined on a list with ClickUp: Get List Custom Fields, then write values with ClickUp: Set Custom Field Value. Field ids come from ClickUp itself, so a workflow keeps working when a field is renamed.
Time tracking and timesheets
Start and stop timers, create and correct time entries, read the running timer, and pull entries for a date range or an assignee. Useful for billing exports, utilization reports, and catching work that never got logged.
Provisioning new project structure
When a new client or project starts, create the space, folders, lists, and views in one run, seed tasks from a task template, and apply the tags and custom field defaults your team expects, instead of copying a structure by hand.
Example: An inbound bug report becomes a triaged ClickUp task
Built on the Automations canvas in a few minutes, or described in plain language to Matter and built for you.
Trigger: an incoming webhook fires when a bug report arrives from your product or support tool.
AI step: Matter reads the report, writes a one-paragraph summary, and picks a priority.
ClickUp: Get List Custom Fields reads the fields defined on your engineering list, so the workflow writes to real field ids rather than guessed ones.
ClickUp: Create Task creates the task in that list with the summary, an assignee, and a due date.
ClickUp: Set Custom Field Value writes the priority, and ClickUp: Add Tag to Task tags it for the current sprint.
ClickUp: Create Task Comment posts the original report text on the task, so the full context travels with the work.
ClickUp MCP questions, answered
Can an AI agent create and update ClickUp tasks through this MCP?
Yes. 79 of the 119 nodes are write nodes, so an agent can create, update, move, merge, and delete tasks, post and edit comments, manage checklists and tags, set and clear custom field values, add and remove dependencies and task links, and run timers. Every action goes through a node on the canvas, so you can see what ran and with what inputs.
Does this work with Claude, ChatGPT, or other AI assistants?
Yes. Mattering exposes these nodes over MCP, an open protocol for connecting AI assistants to tools, so any MCP-capable assistant, including Claude and ChatGPT, can connect to your workspace and work with ClickUp through them. Matter, the assistant built into the platform, uses the same nodes natively. It is the natively integrated agent, never the only one.
What credential does the connector use?
A ClickUp personal API token, or an OAuth access token, stored encrypted in Google Secret Manager. ClickUp is unusual here: the token goes in the Authorization header with no Bearer prefix, and Mattering sends whatever you paste, unchanged. Paste the token on its own. A personal token carries your own ClickUp permissions, so the connector can reach exactly what your account can reach.
Are there trigger nodes that fire when something changes in ClickUp?
Not directly. The four webhook nodes manage ClickUp webhook subscriptions (list, create, update, and delete them); they do not deliver events into Mattering by themselves. To react to ClickUp changes, add an Incoming Webhook trigger to your automation, copy its URL, and point a ClickUp webhook at it with ClickUp: Create Webhook. Polling with the Scheduled trigger plus ClickUp: Get Filtered Team Tasks is the other common pattern.
Does it cover ClickUp time tracking?
Yes, both generations. Time Tracking 2.0 has nodes for listing entries in a workspace, reading a single entry, creating, updating, and deleting entries, reading the running timer, starting and stopping a timer, reading an entry's change history, and managing time entry tags. The legacy per-task time endpoints are also present and labelled legacy so you can tell them apart.
What about the Enterprise-only parts of the API?
The guest nodes (invite, get, edit, remove, and grant or revoke access on a task, list, or folder) and the workspace member nodes (invite, get, edit, remove) are included and labelled Enterprise, because that is what ClickUp requires to call them. They are in the palette for every workspace, but the call only succeeds if your ClickUp plan and role allow it. Otherwise ClickUp returns a permission error on the node output.
What if the filter I need is not a field on the node?
Every node accepts an extra_query object that is merged into the request querystring. The commonly used filters are typed fields on the node, and anything else ClickUp documents for that endpoint can be passed through extra_query, so you are not blocked waiting for a connector update.
What are ClickUp's API rate limits?
ClickUp rate limits requests per token per minute and the allowance depends on the workspace plan, so ClickUp's own API documentation is the source of truth for current numbers. When a call is throttled, ClickUp returns HTTP 429 and the connector surfaces that on the node output, so a workflow can wait and retry rather than failing silently.
Put ClickUp to work inside your workspace
Connect once, then use every node in visual automations and AI agent workflows across the Mattering platform.
All product names, logos, and brands are property of their respective owners and are used for identification purposes only. Use of these names, logos, and brands does not imply endorsement or affiliation. ClickUp is a product of its respective owner; Mattering is an independent platform.