ClickUp keeps all your tasks, projects, and collaboration neatly organized in one place. The ClickUp MCP integration lets you view, create, and update tasks, lists, folders, and more directly from Gumloop workflows, so every project stays perfectly in sync without switching tabs.
Tap into ClickUp’s full hierarchy - workspaces, spaces, folders, lists, and tasks - and manage every layer of your projects with a single natural language prompt.

What is ClickUp MCP?

When you create a ClickUp node with AI, Gumloop automatically builds a custom node that understands the ClickUp API. Simply type what you need and the node translates your prompt into the correct ClickUp call, returning exactly the data you requested. You can reuse the same node across any workflow for fast, reliable access to your ClickUp workspace.

What Can It Do for You?

  • Retrieve workspaces, spaces, folders, lists, and tasks without writing any code
  • Create or update tasks, lists, and folders in seconds
  • Add comments to tasks to keep teammates informed
  • Chain ClickUp data with other Gumloop nodes (Ask AI, Google Sheets Writer, Slack Message Sender) for fully automated project workflows

Available Tools

ToolWhat It DoesExample Use
Get Authenticated UserReturns details about the current ClickUp user”Get my user profile and return id, username, and email”
Get WorkspacesLists all workspaces (teams) the user can access”List all my workspaces and return workspace_id and name”
Get SpacesLists spaces inside a workspace”For workspace ‘Marketing Team’, list spaces and return space_id and name”
Get FoldersLists folders inside a space”For space ‘Q2 Campaigns’, list folders and return folder_id and name”
Get ListsLists lists inside a folder or space”For folder ‘Product Launch’, list all lists and return list_id and name”
Get TasksRetrieves tasks from a list”Get tasks from list ‘Sprint 23’ where status is ‘in progress’, return task_id, name, and status”
Get Task By IdRetrieves a single task by its ID”Get task ‘Website Redesign Homepage’ and return name, status, and due_date”
Create TaskCreates a task within a list”Create a task named ‘Review Q3 Budget Proposal’ in list ‘Finance Tasks’, set due_date to 2024-06-15, and return task_id and name”
Update TaskUpdates an existing task”Update task ‘API Documentation’ change status to ‘complete’, and return task_id and status”
Add CommentAdds a comment to a task”Add comment ‘Waiting on design approval from client’ to task ‘Logo Redesign’ and return comment_id”
Create ListCreates a list in a folder or space”Create a list called ‘June Sprint’ in folder ‘Development’, return list_id and name”
Create FolderCreates a folder in a space”Create a folder named ‘Q3 Planning’ in space ‘Operations’ and return folder_id and name”

How to Use

1

Create Your ClickUp MCP Node

Go to your node library, search for ClickUp, and click “Create a node with AI”.
2

Add Your Prompt

Drag the ClickUp node to your canvas and type a clear, single-action prompt such as “Get tasks from list ID 321 where status is in progress.”
3

Test Your Node

Run the node to verify the output. Adjust your prompt or filters if needed.
4

Save and Reuse

Once everything looks good, save the node to your library and drop it into any workflow.

Example Prompts

Here are some prompts that work well with ClickUp MCP: Retrieve tasks from a list
Get tasks from a given List URL where status is "in progress" and return task id, name, status, and due_date
Create a new task
Create a task named "Design homepage banner" in list ID 321, assign to user with the provided email address, set priority to high, and return task id and name
Update an existing task
Given a task URL: update status to "complete" and add label "Q3", then return task id and status
Add a comment to a task
Add comment "Please review the latest copy by Friday" to task ID 987654 and return comment id
Start with identifiers you already know (workspace, list, or task IDs). Once you have them, you can chain nodes to drill deeper or perform updates without searching again.

Troubleshooting

If your ClickUp MCP node isn’t behaving as expected, try the tips below.

Keep Prompts Simple and Specific

  • Good: “Get tasks from list ID 321 and return id, name, status”
  • Bad: “Get tasks from all my workspaces, fetch the task descriptions and then create a summary”
While this prompt might work, it’s more efficient to break it into separate nodes. ClickUp MCP works best with focused, single-action prompts.

Match What ClickUp Can Do

  • Good: “Create a list called ‘Sprint Backlog’ in folder ID 654321”
  • Bad: “Create a Google Calendar event for every ClickUp task”
ClickUp MCP excels at project management actions. For calendar tasks, combine it with an appropriate Google Calendar node in your workflow.

Break Complex Tasks Into Steps

Instead of trying to do everything in one prompt (which might cause timeouts or errors):
Find all tasks in every workspace that are overdue, mark them complete, add a comment, then email the team a summary
Break this into smaller, focused nodes that each handle one task:
1

Step 1: Get Overdue Tasks

Get tasks from list ID 321 where due_date is before today and status is not complete, return task ids
2

Step 2: Update Tasks

Update task IDs task_ids to set status to complete
3

Step 3: Add Comments

Add comment “Marked complete automatically” to task IDs task_ids
4

Step 4: Summarize using an 'Ask AI' node

Use Ask AI to summarize the completed tasks for the team
Connect these nodes sequentially in your workflow. The task IDs from Step 1 feed into Steps 2 and 3, and the updated task details flow into Step 4.

Focus on Data Retrieval

ClickUp MCP is great at getting information from ClickUp. For deeper analysis or generating content, feed the results into Ask AI or Google Sheets Writer. Example:
  • Good prompt: “Get lists in folder ID 654321 and return list id and name”
  • Bad prompt: “Get lists in folder ID 654321 and write a 500-word report on project health”
Use ClickUp MCP to retrieve the data, then pass the output to Ask AI for analysis or report generation.

Troubleshooting Node Creation

Need More Help?