← Back to all apps

ClickUp

Productivityby ClickUp
Open in ChatGPTWebsite

The ClickUp connector enables secure, real-time interaction between AI agents like Claude and your ClickUp workspace. Unlock powerful AI-driven automation by connecting your favorite AI tools directly to ClickUp tasks, docs, Chat, and more.

32ChatGPT Tools
35Claude Tools
ClickUpDeveloper
ProductivityCategory

Use Cases

productivitycommunication

Available Tools

Clickup Add Tag To Task

clickup_add_tag_to_task
Full Description

Add existing tag to task. Tag must exist in space. Note: Will fail if tag doesn't exist.

Parameters (2 required, 1 optional)
Required
tag_namestring

Name of the tag to add to the task. The tag must already exist in the space.

task_idstring

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
workspace_idstring

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').

Clickup Add Time Entry

clickup_add_time_entry
Full Description

Add a manual time entry to a task. You can provide either (start + duration) OR (start + end). The tool will calculate missing values. Requires task_id, start time, and either duration or end time. Supports description, billable flag, and tags.

Parameters (2 required, 6 optional)
Required
startstring

Start time in YYYY-MM-DD HH:MM format (e.g., '2025-01-15 09:30'). Time is required for time tracking entries.

task_idstring

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
billableboolean

Whether this time is billable. Default is workspace setting.

descriptionstring

Description for the time entry. Keep short and simple, or omit for best compatibility.

durationstring

Duration of the time entry. Format as 'Xh Ym' (e.g., '1h 30m') or just minutes (e.g., '90m'). Either duration or end_time is required.

end_timestring

End time in YYYY-MM-DD HH:MM format (e.g., '2025-01-15 11:00'). Time is required for time tracking entries.

tagsarray

Array of tag names to assign to the time entry.

workspace_idstring

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').

Clickup Attach Task File

clickup_attach_task_file
Full Description

Attach file to task. Requires task_id. File sources: 1) base64 + filename, 2) URL (http/https).

Parameters (1 required, 5 optional)
Required
task_idstring

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
auth_headerstring

Authorization header to use when downloading from the web URL.

file_datastring

Base64-encoded content of the file (without the data URL prefix).

file_namestring

Name of the file to be attached (include the extension). Required when using file_data.

file_urlstring

URL to download the file from (must start with http:// or https://).

workspace_idstring

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').

Clickup Create Document

clickup_create_document
Full Description

Create a document in a ClickUp space, folder, or list. Requires name, parent info, visibility and create_page flag.

Parameters (4 required, 1 optional)
Required
create_pageboolean

Whether to create an initial blank page

namestring

Name and Title of the document

parentobject

Parent container information

visibilitystring

Document visibility setting

Options:PUBLICPRIVATE
Optional
workspace_idstring

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').

Clickup Create Document Page

clickup_create_document_page
Full Description

Create a new page in a ClickUp document.

Parameters (3 required, 4 optional)
Required
contentstring

Content of the page

document_idstring

ID of the document to create the page in

namestring

Name and title of the page

Optional
content_formatstring

The format of the page content

Options:text/mdtext/plain
Default: text/md
parent_page_idstring

ID of the parent page (if this is a sub-page)

sub_titlestring

Subtitle of the page

workspace_idstring

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').

Clickup Create Folder

clickup_create_folder
Full Description

Create folder in ClickUp space. Use space_id (preferred) or space_name + folder name. Supports override_statuses for folder-specific statuses. Use clickup_create_list_in_folder to add lists after creation.

Parameters (1 required, 4 optional)
Required
namestring

Name of the folder.

Optional
override_statusesboolean

Whether to override space statuses with folder-specific statuses.

space_idstring

ID of the space to create the folder in (preferred). Provide this instead of space_name if you already have it.

space_namestring

Name of the space to create the folder in. Use this when space_id is not available.

workspace_idstring

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').

Clickup Create List

clickup_create_list
Full Description

Create a list in a ClickUp space efficiently. The system automatically detects workspace ID and resolves space names. Use space_name (preferred for simplicity) or space_id + list name. Name is required. For lists in folders, use clickup_create_list_in_folder. Supports content, due_date, priority, assignee, and status. Note: No need to look up workspace hierarchy or space IDs first - the system handles space name resolution automatically.

Parameters (1 required, 8 optional)
Required
namestring

Name of the list.

Optional
assigneenumber

User ID to assign the list to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.

contentstring

Description or content of the list.

due_datestring

Due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format

prioritystring

Priority value: 'urgent', 'high', 'normal', or 'low'.

Options:urgenthighnormallow
space_idstring

ID of the space to create the list in. Provide this instead of space_name if you already have the ID.

space_namestring

Name of the space to create the list in. Alternative to space_id; one of them must be provided.

statusstring

Status of the list.

workspace_idstring

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').

Clickup Create List In Folder

clickup_create_list_in_folder
Full Description

Create a list in a ClickUp folder. Requires folder_id and list name. Supports content and status. If you need to get a folder ID from a folder name, use clickup_get_folder first.

Parameters (2 required, 3 optional)
Required
folder_idstring

ID of the folder to create the list in.

namestring

Name of the list.

Optional
contentstring

Description or content of the list.

statusstring

Status of the list (uses folder default if not specified).

workspace_idstring

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').

Clickup Create Task

clickup_create_task
Full Description

Create task in a ClickUp list. Requires task name and list_id. ALWAYS ask user which list to use - never guess. Use clickup_get_list to resolve list names to IDs. Supports assignees as array of user IDs, emails, usernames, or "me".

Parameters (2 required, 12 optional)
Required
list_idstring

ID of the list where the task should be created. Use clickup_get_list to find the list ID from a list name if needed.

namestring

Task name. Ask the user what they want to name the task.

Optional
assigneesarray

Array of assignee user IDs (as strings). Use clickup_resolve_assignees to convert emails, usernames, or "me" to user IDs if needed.

check_required_custom_fieldsboolean

Flag to check if all required custom fields are set before saving the task.

custom_fieldsarray

Array of custom field values to set on the task. Each object must have an 'id' and 'value' property.

descriptionstring

Plain text description for the task.

due_datestring

Due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format (e.g., '2025-12-31' or '2025-12-31 14:30')

markdown_descriptionstring

Markdown formatted description for the task. If provided, this takes precedence over description.

parentstring

ID of the parent task. When specified, this task will be created as a subtask of the specified parent task.

prioritystring

Task priority: 'urgent', 'high', 'normal', or 'low'. If not provided, task will have no priority assigned.

Options:urgenthighnormallow
start_datestring

Start date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format (e.g., '2025-01-01' or '2025-01-01 09:00')

statusstring

Override the default ClickUp status. In most cases, omit this to use ClickUp defaults.

tagsarray

Array of tag names to assign to the task. The tags must already exist in the space.

workspace_idstring

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').

Clickup Create Task Comment

clickup_create_task_comment
Full Description

Create task comment. Requires task_id and comment_text. Supports notify_all to alert assignees and assignee to assign the comment.

Parameters (2 required, 3 optional)
Required
comment_textstring

Text content of the comment to create.

task_idstring

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
assigneenumber

User ID to assign the comment to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.

notify_allboolean

Whether to notify all assignees. Default is false.

workspace_idstring

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').

Clickup Find Member By Name

clickup_find_member_by_name
Full Description

Get a member in the ClickUp workspace by name or email. Returns the member object if found, or null if not found.

Parameters (1 required, 1 optional)
Required
name_or_emailstring

The name or email of the member to find.

Optional
workspace_idstring

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').

Clickup Get Chat Channels

clickup_get_chat_channels
Full Description

Get chat channels in a workspace. Allows you to see available chat channels including their members, privacy settings, and creation details. Supports pagination using the cursor parameter.

Parameters (0 required, 2 optional)
Optional
cursorstring

Cursor for pagination. Use the next_cursor value from the previous response to fetch the next page of results.

workspace_idstring

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').

Clickup Get Current Time Entry

clickup_get_current_time_entry
Full Description

Get the currently running time entry, if any. No parameters needed.

Parameters (0 required, 1 optional)
Optional
workspace_idstring

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').

Clickup Get Document Pages

clickup_get_document_pages
Full Description

Get the content of specific pages from a document.

Parameters (2 required, 2 optional)
Required
document_idstring

ID of the document to get pages from

page_idsarray

Array of page IDs to retrieve

Optional
content_formatstring

Format of the content to retrieve

Options:text/mdtext/html
workspace_idstring

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').

Clickup Get Folder

clickup_get_folder
Full Description

Get details of a ClickUp folder by ID or name. 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. Accepts either folder_id or folder_name + space info.

Parameters (0 required, 5 optional)
Optional
folder_idstring

ID of the folder to retrieve.

folder_namestring

Name of the folder to retrieve. When using this, you must also provide space_id or space_name.

space_idstring

ID of the space containing the folder (required with folder_name).

space_namestring

Name of the space containing the folder (required with folder_name).

workspace_idstring

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').

Clickup Get List

clickup_get_list
Full Description

Get details of a ClickUp list by ID or name. 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. Accepts either list_id or list_name.

Parameters (0 required, 3 optional)
Optional
list_idstring

ID of the list to retrieve.

list_namestring

Name of the list to retrieve. The tool will search for a list with this name.

workspace_idstring

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').

Clickup Get Task

clickup_get_task
Full Description

Get task details by task_id (works with regular/custom IDs). Set subtasks=true to include all subtask details.

Response Size Optimization:

  • Use detail_level='summary' for lightweight responses when full details aren't needed
  • Responses exceeding 50,000 tokens automatically switch to summary format to prevent client issues
  • Summary format includes essential fields: id, name, status, description (truncated), assignees, tags, due_date, url
Parameters (1 required, 3 optional)
Required
task_idstring

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
detail_levelstring

Level of detail to return. Use 'summary' for lightweight responses or 'detailed' for full task data. Defaults to 'detailed' but automatically switches to 'summary' if response would be too large.

Options:summarydetailed
subtasksboolean

Whether to include subtasks in the response. Set to true to retrieve full details of all subtasks.

workspace_idstring

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').

Clickup Get Task Comments

clickup_get_task_comments
Full Description

Get task comments. Use start/start_id params for pagination.

Parameters (1 required, 3 optional)
Required
task_idstring

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
startnumber

Timestamp (in milliseconds) to start retrieving comments from. Used for pagination.

start_idstring

Comment ID to start from. Used together with start for pagination.

workspace_idstring

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').

Clickup Get Task Time Entries

clickup_get_task_time_entries
Full Description

Get all time entries for a task with filtering options. Returns all tracked time with user info, descriptions, tags, start/end times, and durations.

Parameters (1 required, 4 optional)
Required
task_idstring

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
end_datestring

End date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format

is_billableboolean

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.

start_datestring

Start date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format

workspace_idstring

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').

Clickup Get Workspace Hierarchy

clickup_get_workspace_hierarchy
Full Description

Get workspace hierarchy (spaces, folders, lists) from your authenticated workspace with pagination support. Workspace ID is automatically detected from your session. Returns tree structure with names and IDs for navigation. Supports pagination for large workspaces and depth control to fetch only needed levels. Note: Use this ONLY when you need to see the workspace structure - most tools can resolve names automatically without this lookup.

Parameters (0 required, 5 optional)
Optional
cursorstring

Pagination cursor from previous response. Use to fetch next page of spaces

limitnumber

Maximum number of spaces to return per page (default: 10, max: 50)

max_depthnumber

Maximum depth of hierarchy to return: 0=spaces only, 1=spaces+folders, 2=spaces+folders+lists (default: 2)

Options:012
space_idsarray

Filter to return only specific spaces by ID.

workspace_idstring

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').

Clickup Get Workspace Members

clickup_get_workspace_members
Full Description

Get all members (users) in the ClickUp workspace/team from your authenticated workspace. No parameters needed - workspace ID is automatically detected. Note: Most tools automatically resolve assignees by name or email without needing this lookup first. Use this ONLY when you need to see all available members.

Parameters (0 required, 1 optional)
Optional
workspace_idstring

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').

Clickup List Document Pages

clickup_list_document_pages
Full Description

Get all pages in a document with optional depth control.

Parameters (1 required, 2 optional)
Required
document_idstring

ID of the document to list pages from

Optional
max_page_depthnumber

Maximum depth of pages to retrieve (-1 for unlimited)

workspace_idstring

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').

Clickup Remove Tag From Task

clickup_remove_tag_from_task
Full Description

Remove tag from task. Only removes tag-task association, tag remains in space.

Parameters (2 required, 1 optional)
Required
tag_namestring

Name of the tag to remove from the task.

task_idstring

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
workspace_idstring

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').

Clickup Resolve Assignees

clickup_resolve_assignees
Full Description

Resolve an array of assignee names or emails to ClickUp user IDs. Returns an array of user IDs, or null for any that cannot be resolved. Note: Most task tools automatically resolve assignees - use this only when you need the user IDs separately.

Parameters (1 required, 1 optional)
Required
assigneesarray

Array of assignee names or emails to resolve.

Optional
workspace_idstring

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').

Clickup Search

clickup_search
Full Description

Universal search across your entire ClickUp workspace. This is a powerful global search tool that finds ANY type of content - tasks, documents, dashboards, attachments, whiteboards, chat messages, and forms.

Use this tool when:

  • You need to find something but don't know exactly where it is or what type it is
  • You want to search across multiple asset types at once
  • You're looking for items by keyword, content, or partial name matches
  • You need to find all items assigned to specific users or created by certain people
  • You want to search within specific spaces, folders, or lists
  • You need to filter by creation date or due date ranges
  • You need results sorted by creation or update time

This tool searches EVERYTHING - it looks inside task names, descriptions, document content, chat messages, file names, and more. Results include highlighted matches and full hierarchy (Space > Folder > List) for context.

Supports advanced filtering by assignees, creators, status, location, asset types, and date ranges (creation date and due date). Date filters accept dates in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format, and use your user timezone. Returns paginated results with a cursor for fetching additional pages.

The results are intelligently formatted for optimal readability, providing a concise overview and structured data for each result.

Note: For specific operations on known items (like updating a task you already identified), use the dedicated tools instead.

Parameters (0 required, 6 optional)
Optional
countnumber

Maximum number of results to return per page (for pagination)

cursorstring

Pagination cursor from previous response. Use to fetch next page of results

filtersobject

Filters to refine search results by various criteria

keywordsstring

Search query string. Use specific keywords to find items

sortarray

Sort criteria for results. Can specify multiple sort fields in priority order

workspace_idstring

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').

Clickup Send Chat Message

clickup_send_chat_message
Full Description

Send a message to a specific chat channel in the workspace. Messages can be either simple messages or posts with additional metadata.

Parameters (2 required, 8 optional)
Required
channel_idstring

ID of the chat channel to send the message to.

contentstring

Message content to send (supports markdown).

Optional
assigneestring

User ID to assign the message to. Use clickup_resolve_assignees to convert email, username, or "me" to user ID if needed.

content_formatstring

Format of the message content.

Options:text/mdtext/plain
Default: text/md
followersarray

Array of user IDs to add as followers of the message. Use clickup_resolve_assignees to convert emails, usernames, or "me" to user IDs if needed.

group_assigneestring

Group ID to assign the message to.

post_subtype_idstring

Subtype ID for the post (required if type is 'post').

post_titlestring

Title for the post (required if type is 'post').

typestring

Type of message to send.

Options:messagepost
Default: message
workspace_idstring

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').

Clickup Start Time Tracking

clickup_start_time_tracking
Full Description

Start time tracking on a task. Supports description, billable status, and tags. Only one timer can be running at a time. For best results, omit extra parameters unless specifically needed.

Parameters (1 required, 4 optional)
Required
task_idstring

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
billableboolean

Whether this time is billable. Default is workspace setting.

descriptionstring

Description for the time entry. Keep short and simple, or omit for best compatibility.

tagsarray

Array of tag names to assign to the time entry.

workspace_idstring

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').

Clickup Stop Time Tracking

clickup_stop_time_tracking
Full Description

Stop the currently running time tracker. Supports description and tags. Returns the completed time entry details.

Parameters (0 required, 3 optional)
Optional
descriptionstring

Description to update or add to the time entry.

tagsarray

Array of tag names to assign to the time entry.

workspace_idstring

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').

Clickup Update Document Page

clickup_update_document_page
Full Description

Update an existing page in a ClickUp document. Supports updating name, subtitle, and content with different edit modes (replace/append/prepend).

Parameters (2 required, 6 optional)
Required
document_idstring

ID of the document containing the page

page_idstring

ID of the page to update

Optional
contentstring

New content for the page

content_edit_modestring

How to update the content. Defaults to replace

Options:replaceappendprepend
content_formatstring

The format of the page content

Options:text/mdtext/plain
Default: text/md
namestring

New name for the page

sub_titlestring

New subtitle for the page

workspace_idstring

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').

Clickup Update Folder

clickup_update_folder
Full Description

Update a ClickUp folder. Requires folder_id + at least one update field (name/override_statuses). Only specified fields updated. Changes apply to all lists in folder. If you need to get a folder ID from a folder name, use clickup_get_folder first.

Parameters (1 required, 3 optional)
Required
folder_idstring

ID of the folder to update.

Optional
namestring

New name for the folder.

override_statusesboolean

Whether to override space statuses with folder-specific statuses.

workspace_idstring

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').

Clickup Update List

clickup_update_list
Full Description

Update a ClickUp list. Requires list_id + at least one update field (name/content/status). Only specified fields updated. If you need to get a list ID from a list name, use clickup_get_list first.

Parameters (1 required, 4 optional)
Required
list_idstring

ID of the list to update.

Optional
contentstring

New description or content for the list.

namestring

New name for the list.

statusstring

New status for the list.

workspace_idstring

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').

Clickup Update Task

clickup_update_task
Full Description

Update task properties. Requires task_id and at least one update field. Custom fields supported as array of {id, value}. Supports assignees as array of user IDs, emails, usernames, or "me".

Parameters (1 required, 11 optional)
Required
task_idstring

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
assigneesarray

Array of assignee user IDs (as strings). Use clickup_resolve_assignees to convert emails, usernames, or "me" to user IDs if needed.

custom_fieldsarray

Array of custom field values to set on the task. Each object must have an 'id' and 'value' property.

descriptionstring

New plain text description. Will be ignored if markdown_description is provided.

due_datestring

Due date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format (e.g., '2025-12-31' or '2025-12-31 14:30'), or null to clear. If not provided, due date will not be changed.

markdown_descriptionstring

New markdown description. Takes precedence over plain text description.

namestring

New name for the task.

prioritystring

Task priority: 'urgent', 'high', 'normal', 'low', or null to clear. If not provided, priority will not be changed.

start_datestring

Start date in YYYY-MM-DD format or date-time in YYYY-MM-DD HH:MM format (e.g., '2025-01-01' or '2025-01-01 09:00'), or null to clear. If not provided, start date will not be changed.

statusstring

New status. Must be valid for the task's current list.

time_estimatestring

Time estimate for the task. For best compatibility with the ClickUp API, use a numeric value in minutes (e.g., '150' for 2h 30m)

workspace_idstring

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').

Links

Website