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.
| 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'." |
| 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." |
| 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'." |
| 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." |
| 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'." |
| 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?" |
| 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?'" |
| 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?" |
| 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?" |
| 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'." |
| 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'." |
| 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.'" |
| 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'." |
