ClickUp remote MCP connector

  • Updated

The ClickUp remote Model Context Protocol (MCP) connector in Optimizely Opal helps you manage your workspace hierarchy, automate task creation, and track productivity. Use these tools within your Opal workflows to connect AI-assisted collaboration with your ClickUp projects. Whether you are creating folder structures or assigning team members, these tools connect Opal's AI features to your ClickUp projects.

The ClickUp remote MCP is managed by ClickUp. See ClickUp's MCP Server in their documentation for information.

First, an Opal administrator must Connect the ClickUp Remote MCP to Opal. After adding the MCP server, individual Opal users and agent builders log in to ClickUp to access their information from Opal. Administrators need to add the ClickUp remote MCP only once.

Connect the ClickUp remote MCP to Opal

To connect the ClickUp remote MCP to Opal, complete the following steps as an Opal administrator:

  1. Go to Tools > Connectors in Opal.

  2. Click Add Remote MCP. 

    Screenshot of the Opal Connectors page where the Add Remote MCP button is visible
  3. Click ClickUp.
  4. Click Next.
  5. Click Connect to ClickUp.
  6. Complete required access configuration in the pop-up window.
  7. Click Accept.

The ClickUp tile is now available on the Connectors tab for users to authenticate with their personal accounts.

Screenshot of the Opal Connectors tab showing the ClickUp connector tile available for user authentication

Authenticate with ClickUp

After an administrator connects the ClickUp remote MCP to Opal, you can log in to ClickUp. User-level authentication ensures Opal users and agent builders can access only their authorized ClickUp data.

To authenticate, complete the following steps in Opal:

  1. Go to Tools > Connectors.
  2. Click Connect for ClickUp.
  3. Log in to ClickUp.

After you connect to ClickUp, the ClickUp connector tools become available in Opal Chat, agents, and workflows.

ClickUp connector tools

After an administrator connects the ClickUp remote MCP to Opal and you log in to ClickUp using User-level authentication for ClickUp, call the following tools in Opal. Click a tool name to expand it and view usage guidance, parameters, and example prompts. If you do not provide a required parameter, Opal prompts you for it.

Communication

clickup_create_task_comment – Add a new comment to a specific ClickUp task.
  • When to use
    • Post an update or feedback on a task.
    • Assign a comment to a teammate to ensure they see it.
    • Notify all watchers of a task about new information.
  • Parameters
    • task_id – The unique identifier for the task.
    • comment_text – The content of the comment.
    • (Optional) assignee – User ID to assign the comment to.
    • (Optional) notify_all – Boolean to notify all people watching the task (default: false).
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Add a comment to task DEV-123 stating that the PR is ready for review.
    • Comment on task 'Update website' and assign it to user@optimizely.com.
clickup_get_chat_channel_messages – Retrieve a list of messages from a specific chat channel.
  • When to use
    • Read through the conversation history of a specific chat channel.
    • Retrieve past updates or decisions made within a ClickUp chat.
  • Parameters
    • channel_id – The unique identifier for the chat channel.
    • (Optional) before – Retrieve messages sent before this timestamp (ISO 8601).
    • (Optional) limit – The maximum number of messages to return (default: 25, max: 100).
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Show me the last 10 messages from the 'Project Phoenix' chat channel.
    • What was discussed in the chat yesterday?
clickup_get_chat_channels – List all available chat channels within a workspace or specific location.
  • When to use
    • Find the correct channel ID for sending or reading messages.
    • Browse available communication channels in a specific Space, Folder, or List.
  • Parameters
    • (Optional) parent_id – The ID of the Space, Folder, or List to filter channels.
    • (Optional) parent_type – The type of the parent container ('space', 'folder', or 'list').
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • List all chat channels in the Engineering Space.
    • What are the available chats for this workspace?
clickup_get_chat_message_replies – Retrieve all replies to a specific parent message in a chat channel.
  • When to use
    • View a threaded conversation branching off from a specific chat message.
    • Check for follow-up responses to a post or question in a channel.
  • Parameters
    • message_id – The unique identifier of the parent message.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
    • (Optional) cursor – Cursor for pagination. 
    • (Optional) limit – Maximum number of replies to return.
  • Example prompts
    • Show me the replies to the message about the new logo design.
    • Get all the thread responses for chat message 12345.
clickup_get_task_comments – Fetch all comments associated with a specific task.
  • When to use
    • Review the conversation history and feedback log of a task.
    • Audit changes or notes left by team members over time.
  • Parameters
    • task_id – The unique identifier for the task.
    • (Optional) limit – Maximum number of comments to return.
    • (Optional) start_id – The ID of the comment to start fetching from (for pagination).
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Get all comments for task #862abc123.
    • Show me the last 5 comments left on the 'Fix Login bug' task.
clickup_get_threaded_comments – Retrieve replies associated with a specific parent comment.
  • When to use
    • View the specific replies to a comment on a task.
    • Drill down into a sub-conversation within a task's feedback loop.
  • Parameters
    • comment_id – The unique identifier of the parent task comment.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Show me the threaded replies for comment ID 56789.
    • Fetch all responses to the design critique comment on task CX-45.
clickup_send_chat_message – Send a new message or post to a specific chat channel.
  • When to use
    • Post a quick update or message to a team channel.
    • Create a new 'post' type message with a title and specific content format.
    • Assign messages to specific users or add followers to a thread.
  • Parameters
    • channel_id – The unique identifier for the chat channel.
    • content – The body content of the message (supports markdown).
    • (Optional) assignee – User ID to assign the message to.
    • (Optional) content_format – The format of the content (for example, 'markdown').
    • (Optional) followers – Array of user IDs to add as followers.
    • (Optional) group_assignee – Group ID to assign the message to.
    • (Optional) post_subtype_id – Subtype ID for the post (required if type is 'post').
    • (Optional) post_title – Title for the post (required if type is 'post').
    • (Optional) type – The type of message (for example, 'post' or standard message).
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Send a message to the 'General' channel saying 'Meeting starts in 5 minutes'.
    • Create a new project update post in the 'Marketing' channel with the title 'Q2 Strategy'.

Docs and pages

clickup_create_document – Create a document in a ClickUp space, folder, or list.
  • When to use
    • Initialize a new document with specific visibility and parent container information.
    • Ensure a blank page is created within the new Doc using the create_page flag.
  • Parameters
    • parent – Parent container information
    • visibility – Document visibility setting
    • create_page – Whether to create an initial blank page (boolean)
    • name – Name and Title of the document
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace
  • Example prompts
    • Create a public document called 'Project Assets' in space 12345.
clickup_create_document_page – Create a new page in a ClickUp document.
  • When to use
    • Add a new content page to an existing ClickUp document.
    • Create nested sub-pages by specifying a parent_page_id.
  • Parameters
    • content – Content of the page
    • document_id – ID of the document to create the page in
    • name – Name and title of the page
    • (Optional) content_format – The format of the page content
    • (Optional) parent_page_id – ID of the parent page (if this is a sub-page)
    • (Optional) sub_title – Subtitle of the page
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace
  • Example prompts
    • Add a page called 'Budget' to document doc_789.
clickup_get_document_pages – Get the content of specific pages from a document.
  • When to use
    • Retrieve the full text and metadata of one or multiple pages in a Doc.
    • Extract content for searching or analysis.
  • Parameters
    • document_id – ID of the document to get pages from
    • page_ids – Array of page IDs to retrieve
    • (Optional) content_format – Format of the content to retrieve
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace
  • Example prompts
    • Show me the content of pages p_1 and p_2 from document d_345.
clickup_list_document_pages – Get all pages in a document with optional depth control.
  • When to use
    • See the hierarchy and structure of all pages in a document.
    • Discover page IDs within a specific depth level.
  • Parameters
    • document_id – ID of the document to list pages from
    • (Optional) max_page_depth – Maximum depth of pages to retrieve (-1 for unlimited)
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace
  • Example prompts
    • List all pages in document doc_abc.
clickup_update_document_page – Update an existing page in a ClickUp document.
  • When to use
    • Replace the entire content of a specific page.
    • Modify a page's name or subtitle without losing the page ID.
  • Parameters
    • document_id – ID of the document containing the page
    • page_id – ID of the page to update
    • (Optional) content – New content that replaces the entire existing page content
    • (Optional) content_format – The format of the page content
    • (Optional) name – New name for the page
    • (Optional) sub_title – New subtitle for the page
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace
  • Example prompts
    • Update the content of page p_567 in document d_890.

Global search

clickup_search – Universal search across your entire ClickUp workspace.
  • When to use
    • Universal search tool that finds any type of content (tasks, documents, dashboards, attachments, whiteboards, chat messages, and forms) across your entire workspace.
    • Search within task names, descriptions, document content, chat messages, and file names using keywords or partial name matches.
  • Parameters
    • (Optional) count – Maximum number of results to return per page (for pagination).
    • (Optional) cursor – Pagination cursor from previous response. Use to fetch next page of results.
    • (Optional) filters – Filters to refine search results by criteria such as assignees, creators, status, location, asset types, and date ranges.
    • (Optional) keywords – Search query string to find specific items.
    • (Optional) sort – Sort criteria for results, allowing multiple fields in priority order.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Search my ClickUp for 'Q4 Budget' documents.
    • Find all chat messages from last week containing the word 'security'.

Reminders

clickup_create_reminder – Create a personal reminder in your ClickUp workspace.
  • When to use
    • Need to set a personal notification for a future date or time.
    • Create a quick reminder with a title and due date without creating a full task.
  • Parameters
    • due_date – Due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format (uses your timezone).
    • title – Title for the reminder.
    • (Optional) description – Optional description with additional details for the reminder.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Remind me to call the client at 2:30 PM tomorrow.
    • Create a reminder for 2026-05-01 titled "Check Q1 report".
clickup_search_reminders – Search and list reminders in your ClickUp workspace.
  • When to use
    • Find all your upcoming or overdue reminders.
    • Check the status and due dates of personal reminders.
    • Filter reminders by type, status, or update date.
  • Parameters
    • (Optional) cursor – Pagination cursor from previous response.
    • (Optional) due_date_status – Filter reminders by due date status (TODO, LATER, DELETED).
    • (Optional) is_completed – Filter to show only completed or incomplete reminders.
    • (Optional) is_overdue – Filter to show only overdue reminders.
    • (Optional) limit – Maximum number of reminders to return per page (default: 25, max: 100).
    • (Optional) reminder_type – Filter by type of reminder (ASSIGNED_COMMENT, UNANSWERED_MENTION, APPROVAL, SAVED, REMINDER).
    • (Optional) since – Filter reminders updated since this date or date-time.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • List all my overdue reminders.
    • Show me my incomplete reminders updated today.
clickup_update_reminder – Update an existing reminder in your ClickUp workspace.
  • When to use
    • Change the title or description of an existing reminder.
    • Update the due date of a reminder.
    • Mark a reminder as completed or incomplete.
  • Parameters
    • reminder_id – The unique identifier of the reminder to update.
    • (Optional) description – New description for the reminder.
    • (Optional) due_date – New due date in YYYY-MM-DD or YYYY-MM-DD HH:MM format.
    • (Optional) is_completed – Set to true to mark the reminder as completed, false to mark as incomplete.
    • (Optional) title – New title for the reminder.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Mark reminder ID 123abc456 as completed.
    • Change the due date for my reminder to next Friday at 9 AM.

Task enrichment

clickup_add_tag_to_task – Add existing tag to task.
  • When to use
    • Assign an existing tag to a specific ClickUp task.
    • Categorize tasks using pre-defined workspace categories.
  • Parameters
    • tag_name – Name of the tag to add to the task. The tag must already exist in the space.
    • task_id – ID of task. Works with both regular task IDs and custom IDs.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Add the High Priority tag to task DEV-101.
clickup_add_task_dependency – Set a dependency between two tasks.
  • When to use
    • Establish a relationship where one task must wait for another or is blocking another.
    • Link tasks to establish project workflow order.
  • Parameters
    • depends_on – ID of the task that task_id depends on or is blocking.
    • task_id – ID of the task to set the dependency on.
    • type – Type of dependency to add: waiting_on or blocking.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Set task #123 to be waiting on task #456.
clickup_add_task_link – Link two tasks together.
  • When to use
    • Create a simple relationship between two related tasks without strict dependencies.
    • Quickly reference an associated task within another task's context.
  • Parameters
    • links_to – ID of the task to link to.
    • task_id – ID of the task to link from.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Link task "Update Logo" to task "Homepage Redesign".
clickup_attach_task_file – Attach file to task.
  • When to use
    • Upload images, documents, or data directly into a task's attachments.
    • Add files to a task using a public web URL.
  • Parameters
    • task_id – ID of task. Works with both regular task IDs and custom IDs.
    • (Optional) auth_header – Authorization header to use when downloading from the web URL.
    • (Optional) file_data – Base64-encoded content of the file.
    • (Optional) file_name – Name of the file to be attached (include extension).
    • (Optional) file_url – URL to download the file from.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Attach the document at https://example.com/brief.pdf to task #862.
clickup_get_bulk_tasks_time_in_status – Get the time multiple tasks have spent in each status (bulk operation, up to 100 tasks).
  • When to use
    • Measure cycle time or identify bottlenecks across a large set of tasks.
    • Audit status duration history for a group of tasks.
  • Parameters
    • task_ids – Array of task IDs to get time in status for (1-100 tasks).
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • How long have the tasks in the Sprint list spent in the "In Progress" status?
clickup_get_custom_fields – Get custom field definitions at any hierarchy level (list, folder, space, or workspace).
  • When to use
    • Discover available custom fields before setting values on tasks.
    • Understand the field IDs, types, and options for dropdowns/labels.
  • Parameters
    • (Optional) folder_id – Folder ID. Returns custom fields defined on this folder.
    • (Optional) include_workspace – If true, returns workspace-level custom fields.
    • (Optional) list_id – List ID. Returns custom fields defined on this list.
    • (Optional) space_id – Space ID. Returns custom fields defined on this space.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • List all custom fields available in my development list.
clickup_get_task_time_in_status – Get the time a task has spent in each status.
  • When to use
    • Analyze the lifecycle of a specific task within status phases.
    • Retrieve current status elapsed time and status change timestamps.
  • Parameters
    • task_id – The ID of the task (supports both regular and custom task IDs).
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • How long has task DEV-123 been in the To Do status?
clickup_remove_tag_from_task – Remove tag from task.
  • When to use
    • Detach a specific tag from a task when it is no longer relevant.
    • Keep tags in the space but remove them from specific individual items.
  • Parameters
    • tag_name – Name of the tag to remove from the task.
    • task_id – ID of task. Works with both regular task IDs and custom IDs.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Remove the "In Review" tag from task PROJ-15.
clickup_remove_task_dependency – Remove a dependency between two tasks.
  • When to use
    • Break a waiting_on or blocking link between two tasks.
    • Adjust workflow relationships when task prerequisites change.
  • Parameters
    • depends_on – ID of the task that was in the dependency relationship.
    • task_id – ID of the task to remove the dependency from.
    • type – Type of dependency to remove: waiting_on or blocking.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Remove the dependency where task A was waiting on task B.
clickup_remove_task_link – Remove a link between two tasks.
  • When to use
    • Delete a simple link between tasks when they are no longer related.
    • Clear bidirectional task connections.
  • Parameters
    • links_to – ID of the task that was linked to.
    • task_id – ID of the task to remove the link from.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Unlink task ID 123 and task ID 456.

Task operations

clickup_add_task_to_list – Add a task to an additional list.
  • When to use
    • Use when you want to include a task in multiple lists.
    • Requires the Tasks in Multiple Lists ClickApp (a ClickUp workspace add-on) to be enabled.
  • Parameters
    • task_id – ID of the task to add.
    • list_id – ID of the additional list to add the task to.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Add task DEV-123 to the Marketing Launch list.
clickup_create_task – Create a task in a ClickUp list.
  • When to use
    • Use to create a new task within a specific list.
    • Use when you need to set initial task details like assignees, priority, or due dates.
  • Parameters
    • name – Task name.
    • list_id – ID of the list where the task should be created.
    • (Optional) assignees – Array of assignee user IDs, emails, usernames, or "me".
    • (Optional) check_required_custom_fields – Flag to check if all required custom fields are set before saving.
    • (Optional) custom_fields – Array of custom field values to set on the task.
    • (Optional) description – Plain text description for the task.
    • (Optional) due_date – Due date in YYYY-MM-DD or YYYY-MM-DD HH:MM format.
    • (Optional) markdown_description – Markdown formatted description for the task.
    • (Optional) parent – ID of the parent task to create a subtask.
    • (Optional) priority – Task priority: 'urgent', 'high', 'normal', or 'low'.
    • (Optional) start_date – Start date in YYYY-MM-DD or YYYY-MM-DD HH:MM format.
    • (Optional) status – Override the default ClickUp status.
    • (Optional) tags – Array of tag names to assign to the task.
    • (Optional) task_type – Name of the task type (for example, 'Bug', 'Feature').
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Create a task named Update Website in the Website Project list with high priority.
clickup_delete_task – Delete a task from your Workspace.
  • When to use
    • Use to permanently remove a task from ClickUp.
    • Confirm the correct task ID with the user before execution.
  • Parameters
    • task_id – ID of task to delete.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Delete task #866yxy41v.
clickup_filter_tasks – Retrieve tasks with combined filters.
  • When to use
    • Use when you need to find tasks by specific criteria like tags, lists, folders, or spaces.
    • Use when combining multiple filters (for example, specific tag AND list).
    • Use for finding completed tasks within a date range using completion date filters.
  • Parameters
    • (Optional) assignees – Filter by assignee user IDs. Multiple IDs use OR logic. Use clickup_resolve_assignees to convert names/emails/"me" first.
    • (Optional) date_done_from – Filter tasks completed on or after. Format: YYYY-MM-DD
    • (Optional) date_done_to – Filter tasks completed on or before. Format: YYYY-MM-DD
    • (Optional) due_date_from – Filter tasks with due date on or after. Format: YYYY-MM-DD
    • (Optional) due_date_to – Filter tasks with due date on or before. Format: YYYY-MM-DD
    • (Optional) folder_ids – Filter by Folder IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified folders).
    • (Optional) include_closed – Include closed tasks in results
    • (Optional) list_ids – Filter by List IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified lists).
    • (Optional) order_by – Sort results by field
    • (Optional) page – Page number for pagination (0-indexed)
    • (Optional) reverse – Reverse sort order
    • (Optional) space_ids – Filter by Space IDs. Multiple IDs use OR logic (matches tasks in ANY of the specified spaces).
    • (Optional) statuses – Filter by task status names. Multiple statuses use OR logic (matches tasks with ANY of the specified statuses).
    • (Optional) subtasks – Include subtasks in results (default: true)
    • (Optional) tags – Filter by tag names. Multiple tags use OR logic (matches tasks with ANY of the specified tags).
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this will be automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace. You can find your Workspace ID in the URL when in your workspace (format: 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Show me all tasks in my workspace tagged with bug that were completed last week.
clickup_get_task – Get task details by task_id.
  • When to use
    • Use to retrieve comprehensive information about a single task.
    • Use when you need to see subtasks or specific task metadata.
  • Parameters
    • task_id – ID of task.
    • (Optional) detail_level – Level of detail to return: 'summary' or 'detailed'.
    • (Optional) subtasks – Whether to include subtasks in the response.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Get the details for task DEV-456 including all its subtasks.
clickup_move_task – Move a task to a new home list.
  • When to use
    • Use to change the primary home list of a task.
    • The task is removed from its current list and placed into the destination list.
  • Parameters
    • list_id – ID of the destination list to move the task into.
    • task_id – ID of the task to move.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Move task DEV-789 to the Completed Tasks list.
clickup_remove_task_from_list – Remove a task from a specific list.
  • When to use
    • Use when a task is in multiple lists and you want to remove it from one of them.
  • Parameters
    • task_id – ID of task to remove.
    • list_id – ID of the list to remove the task from.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace.
  • Example prompts
    • Remove task DEV-123 from the Secondary Review list.
clickup_update_task – Update task properties.
  • When to use
    • Use to modify existing task attributes such as name, status, or assignee.
    • Use when setting or clearing due dates, start dates, or priorities.
    • Use to update description or custom field values.
  • Parameters
    • task_id – ID of task. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.
    • (Optional) assignees – Array of assignee user IDs. Use clickup_resolve_assignees to convert emails, usernames, or "me" to user IDs if needed.
    • (Optional) custom_fields – Array of custom field values to set on the task. Each object must have an 'id' and 'value' property.
    • (Optional) description – New plain text description. Is ignored if markdown_description is provided.
    • (Optional) due_date – To set a due date, you MUST pass the date as a string value in YYYY-MM-DD format (for example, '2025-12-31') or YYYY-MM-DD HH:MM format (for example, '2025-12-31 14:30'). 
    • (Optional) markdown_description – New markdown description. Takes precedence over plain text description.
    • (Optional) name – New name for the task.
    • (Optional) priority – To set a priority, you MUST pass one of: 'urgent', 'high', 'normal', 'low'. 
    • (Optional) start_date – To set a start date, you MUST pass the date as a string value in YYYY-MM-DD format (for example, '2025-01-01') or YYYY-MM-DD HH:MM format (for example, '2025-01-01 09:00').
    • (Optional) status – New status. Must be valid for the task's current list.
    • (Optional) task_type – To change the task type, you MUST pass the type name as a string (for example, 'Bug', 'Feature', 'Milestone'). The type must exist in the workspace. 
    • (Optional) time_estimate – Time estimate for the task. For best compatibility with the ClickUp API, use a numeric value in minutes (for example, '150' for 2h 30m)
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace. You can find your Workspace ID in the URL when in your workspace (format: 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Update the due date for task DEV-1234 to 2026-05-01.

Track time

clickup_add_time_entry – Add a manual time entry to a task.
  • When to use
    • Add a manual time entry to a task.
    • Calculate missing values by providing (start + duration) or (start + end).
  • Parameters
    • task_id – ID of task. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.
    • start – Start time in YYYY-MM-DD HH:MM format (for example, '2025-01-15 09:30'). Time is required for time tracking entries.
    • (Optional) duration – Duration of the time entry. Format as 'Xh Ym' (for example, '1h 30m') or just minutes (for example, '90m'). Either duration or end_time is required.
    • (Optional) end_time – End time in YYYY-MM-DD HH:MM format (for example, '2025-01-15 11:00'). Time is required for time tracking entries.
    • (Optional) description – Description for the time entry. Keep short and simple, or omit for best compatibility.
    • (Optional) billable – Whether this time is billable. Default is workspace setting.
    • (Optional) tags – Array of tag names to assign to the time entry.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace (formatted as 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Add a 1h 30m manual time entry starting at 2025-01-15 09:30 for task DEV-1234 with description working on feature.
clickup_get_current_time_entry – Get the currently running time entry, if any.
  • When to use
    • Retrieve the currently running time entry or timer in the workspace.
  • Parameters
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace (formatted as 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Show me the currently running time entry.
clickup_get_task_time_entries – Get all time entries for a task with filtering options.
  • When to use
    • Retrieve all tracked time for a specific task including user info, descriptions, tags, start/end times, and durations.
  • Parameters
    • task_id – ID of task. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.
    • (Optional) start_date – Start date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format.
    • (Optional) end_date – End date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format.
    • (Optional) is_billable – Filter by billable status. Set to true to get only billable time entries, false for non-billable entries. Omit to get all entries regardless of billable status.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace (formatted as 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Get all time entries for task DEV-1234 between 2025-01-01 and 2025-01-31.
clickup_get_time_entries – Get time entries across all tasks for reporting.
  • When to use
    • Get time entries across all tasks within a date range for reporting purposes.
    • Query the entire workspace to generate time tracking reports.
  • Parameters
    • start_date – Start date for the reporting period in YYYY-MM-DD or YYYY-MM-DD HH:MM format (for example, '2025-01-01' or '2025-01-01 09:00').
    • end_date – End date for the reporting period in YYYY-MM-DD or YYYY-MM-DD HH:MM format (for example, '2025-01-31' or '2025-01-31 17:00').
    • (Optional) assignee_id – User ID to filter time entries by assignee. Use clickup_resolve_assignees to convert email, username, or 'me' to user ID if needed.
    • (Optional) is_billable – Filter by billable status. Set to true for only billable entries, false for non-billable. Omit to get all entries.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace (format: 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Get all time entries for the entire workspace from 2025-01-01 to 2025-01-31.
clickup_start_time_tracking – Start time tracking on a task.
  • When to use
    • Start time tracking on a task.
  • Parameters
    • task_id – ID of task. Works with both regular task IDs and custom IDs (like 'DEV-1234'). Use clickup_search to find task ID by name if needed.
    • (Optional) billable – Whether this time is billable. Default is workspace setting.
    • (Optional) description – Description for the time entry. Keep short and simple, or omit for best compatibility.
    • (Optional) tags – Array of tag names to assign to the time entry.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace (format: 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Start tracking time on task DEV-1234 with description working on documentation.
clickup_stop_time_tracking – Stop the currently running time tracker.
  • When to use
    • Stop the currently running time tracker.
  • Parameters
    • (Optional) description – Description to update or add to the time entry.
    • (Optional) tags – Array of tag names to assign to the time entry.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace (format: 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Stop the current timer and add description finished task.

Users and teams

clickup_find_member_by_name – Retrieve a workspace member by name or email.
  • When to use
    • Use this tool to get a member object in the ClickUp workspace.
    • Useful for retrieving details about a specific user when you have their name or email address.
  • Parameters
    • name_or_email – The name or email of the member to find.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace. You can find your Workspace ID in the URL when in your workspace (format: 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Find the member with the email trisha.hanlon@optimizely.com.
clickup_get_workspace_members – List all users in the workspace.
  • When to use
    • Use this tool to get all members (users) in the ClickUp workspace/team from your authenticated workspace.
    • Use this only when you need to see all available members.
  • Parameters
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace. You can find your Workspace ID in the URL when in your workspace (format: 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Show me all of the members in my ClickUp workspace.
clickup_resolve_assignees – Convert names or emails to ClickUp user IDs.
  • When to use
    • Use this tool to resolve an array of assignee names, emails, or "me" to ClickUp user IDs.
    • Use this only when you need the user IDs separately (for example, for search filters).
  • Parameters
    • assignees – Array of assignee names, emails, or "me" to resolve. Use "me" to refer to the currently authenticated user.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID. Only provide this parameter to override the detected workspace. You can find your Workspace ID in the URL when in your workspace (format: 'xxxxxxxx' in 'https://app.clickup.com/xxxxxxxx/home').
  • Example prompts
    • Resolve assignees me and trisha.hanlon@optimizely.com to their user IDs.

Workspace hierarchy

clickup_create_folder – Create folder in ClickUp space. Clause as brief as possible.
  • When to use
    • Use space_id (preferred) or space_name + folder name to create a folder.
    • Supports override_statuses for folder-specific statuses.
  • Parameters
    • name – Name of the folder.
    • (Optional) override_statuses – Whether to override space statuses with folder-specific statuses.
    • (Optional) space_id – ID of the space to create the folder in (preferred). Provide this instead of space_name if you already have it.
    • (Optional) space_name – Name of the space to create the folder in. Use this when space_id is not available.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID.
  • Example prompts
    • Create a folder named Q3 Campaigns in the Marketing space.
clickup_create_list – Create a list in a ClickUp space.
  • When to use
    • Create a list directly in a space using space_name or space_id.
    • Use this tool when no folder parent is required.
  • Parameters
    • name – Name of the list.
    • (Optional) assignee – User ID to assign the list to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.
    • (Optional) content – Description or content of the list.
    • (Optional) due_date – Due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format
    • (Optional) priority – Priority value: 'urgent', 'high', 'normal', or 'low'.
    • (Optional) space_id – ID of the space to create the list in. Provide this instead of space_name if you already have the ID.
    • (Optional) space_name – Name of the space to create the list in. Alternative to space_id. One of them must be provided.
    • (Optional) status – Status of the list.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID.
  • Example prompts
    • Create a list called Content Calendar in the Marketing space with normal priority.
clickup_create_list_in_folder – Create a list in a ClickUp folder.
  • When to use
    • Requires folder_id and list name.
    • Supports content and status.
  • Parameters
    • folder_id – ID of the folder to create the list in.
    • name – Name of the list.
    • (Optional) content – Description or content of the list.
    • (Optional) status – Status of the list (uses folder default if not specified).
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID.
  • Example prompts
    • Inside folder 12345, create a new list named Weekly Sprint.
clickup_get_folder – Get details of a ClickUp folder by ID or name. 
  • When to use
    • Use this tool to lookup a folder ID from a folder name before calling other folder operations.
    • Returns folder details including id, name, and space info.
  • Parameters
    • (Optional) folder_id – ID of the folder to retrieve.
    • (Optional) folder_name – Name of the folder to retrieve. When using this, you must also provide space_id or space_name.
    • (Optional) space_id – ID of the space containing the folder (required with folder_name).
    • (Optional) space_name – Name of the space containing the folder (required with folder_name).
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID.
  • Example prompts
    • What is the ID for the folder named Campaigns in the Marketing space?
clickup_get_list – Get details of a ClickUp list by ID or name.
  • When to use
    • Use this tool to lookup a list ID from a list name before calling other list operations.
    • Returns list details including id, name, content, and space info.
  • Parameters
    • (Optional) list_id – ID of the list to retrieve.
    • (Optional) list_name – Name of the list to retrieve. The tool will search for a list with this name.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID.
  • Example prompts
    • Find the details for the list named To-Do.
clickup_get_workspace_hierarchy – Get workspace hierarchy (spaces, folders, and lists).
  • When to use
    • Returns tree structure with names and IDs for navigation.
    • Supports pagination and depth control.
  • Parameters
    • (Optional) cursor – Pagination cursor from previous response. Use to fetch next page of spaces
    • (Optional) limit – Maximum number of spaces to return per page (default: 10, max: 50)
    • (Optional) max_depth – Maximum depth of hierarchy to return: 0 is spaces only, 1 is spaces and folders, 2 is spaces, folders, and lists (default: 2).
    • (Optional) space_ids – Filter to return only specific spaces by ID.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID.
  • Example prompts
    • Show me the structure of my entire ClickUp workspace.
clickup_update_folder – Update a ClickUp folder. Clause as brief as possible.
  • When to use
    • Requires a folder_id and at least one update field (name or override_statuses).
    • Changes apply to all lists in folder.
  • Parameters
    • folder_id – ID of the folder to update.
    • (Optional) name – New name for the folder.
    • (Optional) override_statuses – Whether to override space statuses with folder-specific statuses.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID.
  • Example prompts
    • Rename folder 12345 to Archive.
clickup_update_list – Update a ClickUp list. Clause as brief as possible.
  • When to use
    • Requires a list_id and at least one update field (name, content. or status).
    • Only specified fields updated.
  • Parameters
    • list_id – ID of the list to update.
    • (Optional) content – New description or content for the list.
    • (Optional) name – New name for the list.
    • (Optional) status – New status for the list.
    • (Optional) workspace_id – The unique identifier for the ClickUp workspace. When not provided, this is automatically populated with your authenticated workspace ID.
  • Example prompts
    • Update the description of list 67890 to New project scope.

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applications.