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
| Tool | What It Does | Example Use |
|---|---|---|
| Get Authenticated User | Returns details about the current ClickUp user | ”Get my user profile and return id, username, and email” |
| Get Workspaces | Lists all workspaces (teams) the user can access | ”List all my workspaces and return workspace_id and name” |
| Get Spaces | Lists spaces inside a workspace | ”For workspace ‘Marketing Team’, list spaces and return space_id and name” |
| Get Folders | Lists folders inside a space | ”For space ‘Q2 Campaigns’, list folders and return folder_id and name” |
| Get Lists | Lists lists inside a folder or space | ”For folder ‘Product Launch’, list all lists and return list_id and name” |
| Get Tasks | Retrieves tasks from a list | ”Get tasks from list ‘Sprint 23’ where status is ‘in progress’, return task_id, name, and status” |
| Get Task By Id | Retrieves a single task by its ID | ”Get task ‘Website Redesign Homepage’ and return name, status, and due_date” |
| Create Task | Creates 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 Task | Updates an existing task | ”Update task ‘API Documentation’ change status to ‘complete’, and return task_id and status” |
| Add Comment | Adds a comment to a task | ”Add comment ‘Waiting on design approval from client’ to task ‘Logo Redesign’ and return comment_id” |
| Create List | Creates a list in a folder or space | ”Create a list called ‘June Sprint’ in folder ‘Development’, return list_id and name” |
| Create Folder | Creates 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 listStart 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):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 complete3
Step 3: Add Comments
Add comment “Marked complete automatically” to task IDs
task_ids4
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
Empty Outputs
Empty Outputs
In the node creation window, click “Request changes” and ask the AI to add debug logs and verify the API response.
Incorrect Results
Incorrect Results
In the node creation window, click “Request changes” and describe what you expected versus what you received.
Errors
Errors
First click “Fix with Gummie”. If multiple attempts fail, simplify your prompt or contact support.
Iterate with Request Changes
Iterate with Request Changes
MCP node creation often requires a few tweaks. Use “Request changes” (in the node creation window) to refine filters, output fields, or pagination.
Need More Help?
- Watch What are MCP Nodes video tutorial
- Check out MCP Best Practices in Gumloop University
- Join the Gumloop Community for support
- View the ClickUp MCP setup guide for Claude and Cursor
- Contact support at support@gumloop.com