Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

ClickUp is a project management platform that organizes tasks, projects, and collaboration in one place. The ClickUp MCP server lets you view, create, and update tasks, lists, and folders using natural language.

​
What Can It Do?

  • Retrieve workspaces, spaces, folders, lists, and tasks without writing code
  • Create and update tasks with assignees, due dates, and priorities
  • Add comments to keep teammates informed
  • Manage project structure by creating lists and folders

​
Where to Use It

Add ClickUp as a tool to any agent. The agent can then interact with your projects conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with ClickUp tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Get tasks from the Sprint 23 list”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

ToolDescription
Get Authenticated UserGet current user details
Get WorkspacesList all workspaces
Get SpacesList spaces in a workspace
Get FoldersList folders in a space
Get ListsList lists in a folder or space
Get TasksRetrieve tasks from a list
Get Task By IdGet a single task
Create TaskCreate a new task
Update TaskUpdate an existing task
Add CommentAdd a comment to a task
Create ListCreate a list in a folder
Create FolderCreate a folder in a space

​
Example Prompts

Use these with your agent or in the Agent Node: Get tasks: 
Show me all in-progress tasks from the Sprint 23 list
Create a task: 
Create a task "Review Q3 Budget" in the Finance Tasks list, due next Friday
Update a task: 
Mark the API Documentation task as complete
Add a comment: 
Add a comment to the Logo Redesign task: "Waiting on client approval"
Explore structure: 
List all folders in the Marketing space

​
Troubleshooting

IssueSolution
Agent not finding the right dataUse specific list names or provide the workspace context
Action not completingCheck that you’ve authenticated and have permissions for the workspace
Unexpected resultsThe agent may chain multiple tools (e.g., finding the list first, then getting tasks). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Create a task in the Marketing folder” will find the workspace, space, and folder first, then create the task. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the ClickUp MCP server using your Gumloop credentials.