Supported Tools
Use these supported tools with ClickUp's MCP Server.
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.
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'." |
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." |
| 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'." |
| Get Workspace Tasks | Retrieves all tasks across the Workspace, often with filters for specific assignees, statuses, or dates. | "Show me all tasks assigned to Jane Doe that are due this week." |
| 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'." |
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?" |
| 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?'" |
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?" |
| 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'." |
Updated about 1 month ago