The ClickUp MCP exposes many of the capabilities available in our API. The real magic happens when it automatically combines and uses multiple tools in a single call to perform various actions together.

Note: Your AI assistant will only be able to perform actions in ClickUp that you have permission to do.

Search

Tool	Definition	Example usage (for an AI assistant)
Search Workspace	Searches for items across the entire ClickUp Workspace, including tasks, Lists, Folders, and Docs.	"Find all tasks related to the 'Q4 Marketing Launch'."
Search tasks by task type	Retrieves tasks filtered by task type.	"Show me the bugs in our sprint."
Search tasks by tag	Retrieves tasks filtered by tags.	"Show me the tasks with the 'UX-quality' tag."

Task management

Tool	Definition	Example usage (for an AI assistant)
Create Task	Creates a new task in a specific List. You can specify details like the task name, description, assignees, due date, and priority.	"Create a task to 'Draft blog post' in the 'Content Pipeline' List, assign it to me, and set the due date for this Friday."
Get Task	Retrieves the full details of a single task using its unique task ID.	"What are the details for task 'Design-123'?"
Update Task	Modifies the properties of an existing task. This can include changing the task's name, description, status, assignees, or due date.	"Change the status of task 'Draft blog post' to 'In Progress' and add 'Review' as a subtask."
Set Custom Fields	Set Custom Fields on tasks. Note: Your AI assistant understands the Custom Fields, options, and supported values that are available on tasks.	"Set the 'release number' to '4.07'."
Delete task	Deletes a task or subtask. Note: Your AI assistant may confirm the correct task is selected before deleting the task.	"Delete the "testing use only" task."

Manage tasks in bulk

Tool	Definition	Example usage (for an AI assistant)
Create Bulk Tasks	Creates multiple tasks in a specified List with a single API call.	"Add these items as new tasks in the 'Onboarding' List: 'Send welcome email', 'Schedule orientation', and 'Set up hardware'."
Update Bulk Tasks	Modifies multiple tasks at once. This is useful for changing the status, assignee, or due date for a group of tasks simultaneously.	"Move all tasks in the 'Sprint 3' List with the 'Ready for Review' status to 'In Review'."

Task attachments

Tool	Definition	Example usage (for an AI assistant)
Attach File to Task	Uploads and attaches a file (like a document, image, or ZIP file) to a specific task.	"Attach this document [file_upload] to the 'Submit Final Report' task."

Task comments

Tool	Definition	Example usage (for an AI assistant)
Get Task Comments	Retrieves all comments from a specific task.	"What's the latest update on the 'Develop new feature' task?"
Get Threaded Replies	Retrieves threaded replies under a parent task comment.	"Summarize this comment thread and tell me my action items."
Create Task Comment	Adds a new comment to a task. This can be used to ask questions, provide updates, or @mention other team members.	"Add a comment to task 'Design-123' saying: '@Mark, can you please provide the latest mockups?'"

Task tags

Tool	Definition	Example usage (for an AI assistant)
Add Tag to Task	Applies an existing tag (label) to a task for categorization.	"Add the 'Urgent' tag to task 'Fix login bug'."
Remove Tag from Task	Removes a specific tag from a task.	"Remove the 'Backend' tag from task 'Update button color'."

Task relationships

Tool	Definition	Example usage (for an AI assistant)
Add task link	Relate two tasks by linking them.	"Link feature 123 with design for feature 123."
Remove task link	Remove links between tasks.	"Remove the link between feature 123 and scope designs for feature 123."
Add dependency	Create a dependency relationship between tasks.	"This task is blocked by its subtask called 'support Google authentication'."
Remove dependency	Remove a dependency relationship between tasks.	"Remove the dependency between feature 123 and support Google authentication."

Move and add tasks to other Lists

Tool	Definition	Example usage (for an AI assistant)
Move task to a new List	Move a task to a new home List.	"Move the feature 123 task from the Backlog List to 'Sprint 3'."
Add task to another List	Add a task to another List.	"Add the feature 123 task to 'Sprint 3'."

Time tracking

Tool	Definition	Example usage (for an AI assistant)
Get Task Time Entries	Retrieves all time log entries for a specific task.	"How much time has been logged for the 'Client Research' task?"
Get time entries for multiple tasks	Retrieves total time entries fro tasks in a specific Space, Folder, or List.	"How much time have we spent on the tasks in the 'feature 123 MVP' List?"
Start Time Tracking	Starts a timer for a specific task for the current user.	"Start tracking time for the 'Code Review' task."
Stop Time Tracking	Stops the currently active timer for the user.	"Stop the timer."
Add Time Entry	Manually adds a block of time (a time entry) to a task, including a start and end time or a duration.	"Log 2 hours of work on the 'Database optimization' task for yesterday."
Get Current Time Entry	Checks if the user has a timer currently running and, if so, returns the details of that time entry.	"What am I currently tracking time for?"

Workspace Hierarchy

Tool	Definition	Example usage (for an AI assistant)
Get Workspace Hierarchy	Retrieves the full structure of the Workspace, including all Spaces, Folders, and Lists.	"Show me all the Lists in the 'Engineering' Space."
Create List	Creates a new List within a specific Folder or Space.	"Create a new List named 'Sprint 4 Planning' in the 'Product' Folder."
Create List in Folder	Creates a new List specifically inside a designated Folder.	"Inside the 'Marketing Campaigns' Folder, create a new List called 'Social Media Content'."
Get List	Retrieves the details and settings for a single List.	"What are the custom statuses for the 'Bugs' List?"
Update List	Modifies the settings of an existing List, such as changing its name or color.	"Rename the 'New Ideas' List to 'Approved Ideas'."
Get Folder	Retrieves the details for a single Folder, including the Lists it contains.	"List all the Lists inside the 'Client Projects' Folder."
Create Folder	Creates a new Folder within a specific Space.	"Create a new Folder named 'Q1 Projects' in the 'Operations' Space."
Update Folder	Modifies the settings of an existing Folder, such as changing its name.	"Rename the 'Design' Folder to 'Design Team'."

Members and assignees

Tool	Definition	Example usage (for an AI assistant)
Get Workspace Members	Retrieves a list of all members and guests in the Workspace.	"Who is on the 'Engineering' team?"
Find Member by Name	Searches for a Workspace member using their name or email.	"What is David Smith's user ID?"
Resolve Assignees	A utility to confirm and retrieve the user objects for a list of potential assignees, often used before adding them to a task.	"When you say, 'Assign this task to Mark and Sarah,' this tool finds the correct user IDs for 'Mark' and 'Sarah'."

Chat

Tool	Definition	Example usage (for an AI assistant)
Get Chat Channels	Retrieves a list of all Chat channels (views) in the Workspace.	"List all available Chat channels."
Send Chat Message	Sends a message to a specific Chat channel.	"Post a message in the 'General' channel: 'Team lunch at 1 PM today.'"

Docs

Tool	Definition	Example usage (for an AI assistant)
Create Document	Creates a new Doc within the Workspace, usually in a specific location (like a Space or Folder) or in the private Docs area.	"Create a new document named 'Project Kickoff Notes' in the 'Project Phoenix' Space."
List Document Pages	Retrieves the structure or table of contents of a Doc, listing all its pages.	"What are the pages in the 'Employee Handbook' Doc?"
Get Document Pages	Retrieves the content of one or more pages from a specific Doc.	"Show me the content of the 'Onboarding' page from the 'Team Wiki' Doc."
Create Document Page	Adds a new page (or sub-page) to an existing Doc.	"Add a new page titled 'Security Protocols' to the 'Company Policies' Doc."
Update Document Page	Edits the content of an existing page within a Doc.	"On the 'Security Protocols' page, add a new section for 'Password Management'."

Time in status reporting

Tool	Definition	Example usage (for an AI assistant)
Get Time in Status for a task	Retrieve the amount of time a task has been in a status.	"How long as feature 123 been in progress?"
Get Time in Status for tasks in a List	Retrieve time in status metrics for multiple tasks.	"How long to tasks usually spend in QA review?"