
Clickup
This is a comprehensive ClickUp integration offering OAuth 2.1 authentication alongside legacy API key support, with 50+ tools covering tasks, time tracking, docs, comments, and chat. Notable features include fuzzy search across workspaces, multi-account session management, and natural language date parsing. It handles bulk operations, custom fields, file attachments via URL or base64, and goals with key results tracking. The implementation emphasizes intelligent ID resolution so you can reference resources by name rather than requiring UUIDs. Reach for this when you need an AI agent to coordinate project management workflows, log time entries, or manage sprint planning directly in ClickUp without manual context switching.
- GitHub stars
- 42
- tools
- 54
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Feb 15, 2026
Tools
54 toolsPublic tool metadata for what this MCP can expose to an agent.
get_workspace_hierarchyReturns all spaces, folders, and lists in workspace (excludes tasks). Use to browse workspace structure. DO NOT use this tool to find tasks, use get_task.
Returns all spaces, folders, and lists in workspace (excludes tasks). Use to browse workspace structure. DO NOT use this tool to find tasks, use get_task.
No parameter schema in public metadata yet.
create_taskCreate a task. Requires: name + (listId or listName). Use create_bulk_tasks for multiple. Supports subtasks via parent, custom_task_type, custom_fields as [{id,value}], assignees as user IDs/emails/names.17 params
Create a task. Requires: name + (listId or listName). Use create_bulk_tasks for multiple. Supports subtasks via parent, custom_task_type, custom_fields as [{id,value}], assignees as user IDs/emails/names.
assigneesarraycheck_required_custom_fieldsbooleancustom_fieldsarraycustom_task_typestringdescriptionstringdueDatestringlistIdstringlistNamestringmarkdown_descriptionstringnamestringparentstringparentListNamestringparentNamestringprioritynumberstartDatestringstatusstringtagsarrayget_taskGet detailed task info. If a task name is provided do not lookup the task ID, it will be resolved automatically.4 params
Get detailed task info. If a task name is provided do not lookup the task ID, it will be resolved automatically.
include_markdown_descriptionbooleanlistNamestringsubtasksbooleantaskstringupdate_taskUpdate task properties. Support automatic name resolution: provide the task Name directly to the 'task' argument and it will be resolved to an ID. You do NOT need to search for the ID using other tools.16 params
Update task properties. Support automatic name resolution: provide the task Name directly to the 'task' argument and it will be resolved to an ID. You do NOT need to search for the ID using other tools.
assigneesarraycustom_fieldsarraycustom_task_typestringdescriptionstringdueDatestringlistNamestringmarkdown_descriptionstringnamestringparentstringparentListNamestringparentNamestringpriorityvaluestartDatestringstatusstringtaskstringtime_estimatestringmove_taskMove task to different list. If a task name is provided do not lookup the task ID, it will be resolved automatically. Warning: statuses may reset.4 params
Move task to different list. If a task name is provided do not lookup the task ID, it will be resolved automatically. Warning: statuses may reset.
listIdstringlistNamestringsourceListNamestringtaskstringduplicate_taskDuplicate task. Provide source task Name or ID. Optionally specify target list.4 params
Duplicate task. Provide source task Name or ID. Optionally specify target list.
listIdstringlistNamestringsourceListNamestringtaskstringdelete_taskPERMANENTLY delete task. If a task name is provided do not lookup the task ID, it will be resolved automatically. Cannot be undone.2 params
PERMANENTLY delete task. If a task name is provided do not lookup the task ID, it will be resolved automatically. Cannot be undone.
listNamestringtaskstringget_task_commentsGet task comments. If a task name is provided do not lookup the task ID, it will be resolved automatically. Set include_replies=true for threaded replies.5 params
Get task comments. If a task name is provided do not lookup the task ID, it will be resolved automatically. Set include_replies=true for threaded replies.
include_repliesbooleanlistNamestringstartnumberstartIdstringtaskstringcreate_task_commentCreate task comment. If a task name is provided do not lookup the task ID, it will be resolved automatically. Provide commentText or formattedComment.6 params
Create task comment. If a task name is provided do not lookup the task ID, it will be resolved automatically. Provide commentText or formattedComment.
assigneenumbercommentTextstringformattedCommentarraylistNamestringnotifyAllbooleantaskstringattach_task_fileAttach file to task. Supports base64, URL, or local path. Requires taskId (preferred) or taskName.11 params
Attach file to task. Supports base64, URL, or local path. Requires taskId (preferred) or taskName.
auth_headerstringchunk_indexnumberchunk_is_lastbooleanchunk_sessionstringchunk_totalnumberfile_datastringfile_namestringfile_urlstringlistNamestringtaskIdstringtaskNamestringcreate_bulk_tasksCreate multiple tasks in one list. Requires: tasks array + (listId or listName). Each task needs name. Options: batch size, concurrency.4 params
Create multiple tasks in one list. Requires: tasks array + (listId or listName). Each task needs name. Options: batch size, concurrency.
listIdstringlistNamestringoptionsvaluetasksarrayupdate_bulk_tasksUpdate multiple tasks. Each task needs: taskId or taskName + listName. Options: batch size, concurrency.2 params
Update multiple tasks. Each task needs: taskId or taskName + listName. Options: batch size, concurrency.
optionsvaluetasksarraymove_bulk_tasksMove multiple tasks to one list. Each task needs: taskId or taskName + listName. Target: targetListId or targetListName. Warning: statuses may reset.4 params
Move multiple tasks to one list. Each task needs: taskId or taskName + listName. Target: targetListId or targetListName. Warning: statuses may reset.
optionsvaluetargetListIdstringtargetListNamestringtasksarraydelete_bulk_tasksPERMANENTLY delete multiple tasks. Each task needs: taskId or taskName + listName. Cannot be undone.2 params
PERMANENTLY delete multiple tasks. Each task needs: taskId or taskName + listName. Cannot be undone.
optionsvaluetasksarrayget_workspace_tasksRetrieve MULTIPLE tasks from workspace using broad filters. Returns full task details including description. Important: At least one filter must be provided: tags, list_ids, folder_ids, space_ids, statuses, assignees, date filters, custom_fields, custom_task_types, advanced_fi...28 params
Retrieve MULTIPLE tasks from workspace using broad filters. Returns full task details including description. Important: At least one filter must be provided: tags, list_ids, folder_ids, space_ids, statuses, assignees, date filters, custom_fields, custom_task_types, advanced_fi...
advanced_filteringobjectarchivedbooleanassigneesarraycustom_fieldsobjectcustom_task_typesarraydate_created_gtnumberdate_created_ltnumberdate_updated_gtnumberdate_updated_ltnumberdetail_levelstringsummary · detailed · namesdue_date_gtnumberdue_date_ltnumberfolder_idsarrayinclude_archived_listsbooleaninclude_closedbooleaninclude_closed_listsbooleaninclude_compact_time_entriesbooleaninclude_markdown_descriptionbooleaninclude_subtasksbooleanlist_idsarray+8 more parameters. See the server's own documentation for the full schema.
get_task_time_entriesGet time entries for a task. Use taskId (preferred) or taskName + optional listName. Optional date/assignee filters.5 params
Get time entries for a task. Use taskId (preferred) or taskName + optional listName. Optional date/assignee filters.
assigneestringendDatestringlistNamestringstartDatestringtaskstringstart_time_trackingStart time tracking on a task. Use taskId (preferred) or taskName + listName. Only one timer can run at a time.5 params
Start time tracking on a task. Use taskId (preferred) or taskName + listName. Only one timer can run at a time.
billablebooleandescriptionstringlistNamestringtagsarraytaskstringstop_time_trackingStop the currently running timer. Returns completed time entry details.2 params
Stop the currently running timer. Returns completed time entry details.
descriptionstringtagsarrayadd_time_entryAdd manual time entry to a task. Requires: start time, duration. Use taskId (preferred) or taskName + listName.7 params
Add manual time entry to a task. Requires: start time, duration. Use taskId (preferred) or taskName + listName.
billablebooleandescriptionstringdurationstringlistNamestringstartstringtagsarraytaskstringdelete_time_entryDelete a time entry. Requires timeEntryId.1 params
Delete a time entry. Requires timeEntryId.
timeEntryIdstringget_current_time_entryGet the currently running time entry, if any.
Get the currently running time entry, if any.
No parameter schema in public metadata yet.
add_task_linkLink two tasks. Requires taskId (preferred) or taskName for both source and target.4 params
Link two tasks. Requires taskId (preferred) or taskName for both source and target.
listNamestringtargetListNamestringtargetTaskstringtaskstringget_task_linksGet dependencies/links for a task. Requires taskId (preferred) or taskName.2 params
Get dependencies/links for a task. Requires taskId (preferred) or taskName.
listNamestringtaskstringdelete_task_linkRemove link between tasks. Requires taskId (preferred) and linkId (target task ID).4 params
Remove link between tasks. Requires taskId (preferred) and linkId (target task ID).
linkIdstringlistNamestringtargetListNamestringtaskstringcreate_listCreate list in space. Requires name + (spaceId or spaceName). Optional: content, dueDate, priority, assignee, status.8 params
Create list in space. Requires name + (spaceId or spaceName). Optional: content, dueDate, priority, assignee, status.
assigneenumbercontentstringdueDatestringnamestringprioritynumberspaceIdstringspaceNamestringstatusstringcreate_list_in_folderCreate list in folder. Requires name + (folderId or folderName + space info). Optional: content, status.7 params
Create list in folder. Requires name + (folderId or folderName + space info). Optional: content, status.
contentstringfolderIdstringfolderNamestringnamestringspaceIdstringspaceNamestringstatusstringget_listGet list details. Requires listId (preferred) or listName.2 params
Get list details. Requires listId (preferred) or listName.
listIdstringlistNamestringupdate_listUpdate list. Requires listId/listName. Optional: name, content, status.5 params
Update list. Requires listId/listName. Optional: name, content, status.
contentstringlistIdstringlistNamestringnamestringstatusstringdelete_listDelete list. Requires listId (preferred) or listName. WARNING: Permanent.2 params
Delete list. Requires listId (preferred) or listName. WARNING: Permanent.
listIdstringlistNamestringcreate_folderCreate folder in space. Requires name + (spaceId or spaceName). Optional: override_statuses.4 params
Create folder in space. Requires name + (spaceId or spaceName). Optional: override_statuses.
namestringoverride_statusesbooleanspaceIdstringspaceNamestringget_folderGet folder details. Requires folderId (preferred) or folderName + space info.4 params
Get folder details. Requires folderId (preferred) or folderName + space info.
folderIdstringfolderNamestringspaceIdstringspaceNamestringupdate_folderUpdate folder. Requires folderId/folderName + space info. Optional: name, override_statuses.6 params
Update folder. Requires folderId/folderName + space info. Optional: name, override_statuses.
folderIdstringfolderNamestringnamestringoverride_statusesbooleanspaceIdstringspaceNamestringdelete_folderDelete folder. Requires folderId (preferred) or folderName + space info. WARNING: Permanent.4 params
Delete folder. Requires folderId (preferred) or folderName + space info. WARNING: Permanent.
folderIdstringfolderNamestringspaceIdstringspaceNamestringget_space_tagsGets all tags in a ClickUp space. Use spaceId (preferred) or spaceName. Tags are defined at space level - check available tags before adding to tasks.2 params
Gets all tags in a ClickUp space. Use spaceId (preferred) or spaceName. Tags are defined at space level - check available tags before adding to tasks.
spaceIdstringspaceNamestringcreate_space_tagCreate tag in ClickUp space. Requires tagName + (spaceId or spaceName). Optional: tagBg/tagFg in HEX or colorCommand for auto-colors.6 params
Create tag in ClickUp space. Requires tagName + (spaceId or spaceName). Optional: tagBg/tagFg in HEX or colorCommand for auto-colors.
colorCommandstringspaceIdstringspaceNamestringtagBgstringtagFgstringtagNamestringupdate_space_tagUpdate tag in ClickUp space. Requires tagName + (spaceId or spaceName). At least one: newTagName, tagBg, tagFg, or colorCommand.7 params
Update tag in ClickUp space. Requires tagName + (spaceId or spaceName). At least one: newTagName, tagBg, tagFg, or colorCommand.
colorCommandstringnewTagNamestringspaceIdstringspaceNamestringtagBgstringtagFgstringtagNamestringdelete_space_tagDelete tag from ClickUp space. Requires tagName + (spaceId or spaceName). Warning: removes from all tasks, cannot be undone.3 params
Delete tag from ClickUp space. Requires tagName + (spaceId or spaceName). Warning: removes from all tasks, cannot be undone.
spaceIdstringspaceNamestringtagNamestringadd_tag_to_taskAdd tag to task. Requires tagName + (taskId or taskName + optional listName). Tag must exist in space.5 params
Add tag to task. Requires tagName + (taskId or taskName + optional listName). Tag must exist in space.
customTaskIdstringlistNamestringtagNamestringtaskIdstringtaskNamestringremove_tag_from_taskRemove tag from task. Requires tagName + (taskId or taskName + optional listName). Only removes association; tag remains in space.5 params
Remove tag from task. Requires tagName + (taskId or taskName + optional listName). Only removes association; tag remains in space.
customTaskIdstringlistNamestringtagNamestringtaskIdstringtaskNamestringget_workspace_membersGet all workspace members. Useful for resolving assignees.
Get all workspace members. Useful for resolving assignees.
No parameter schema in public metadata yet.
find_member_by_nameFind member by name/email. Returns member object or null.1 params
Find member by name/email. Returns member object or null.
nameOrEmailstringresolve_assigneesResolve list of names/emails to User IDs.1 params
Resolve list of names/emails to User IDs.
assigneesarraycreate_chat_channelCreate chat channel in space/folder/list. Requires name.4 params
Create chat channel in space/folder/list. Requires name.
folder_idstringlist_idstringnamestringspace_idstringget_chat_channelsGet all chat channels in the workspace
Get all chat channels in the workspace
No parameter schema in public metadata yet.
create_chat_messageSend message to chat channel. Requires channel_id/name + text.4 params
Send message to chat channel. Requires channel_id/name + text.
channel_idstringchannel_namestringcomment_textstringnotify_allbooleanget_chat_messagesGet messages from channel. Requires channel_id/name.2 params
Get messages from channel. Requires channel_id/name.
channel_idstringchannel_namestringsubmit_feedbackSubmit feedback, bug reports, or feature requests for the ClickUp MCP Server - Premium. Generates a GitHub issue link with pre-filled content. The user can review and submit the issue. PROACTIVE GUIDANCE: Suggest this tool when: - User encounters errors or unexpected tool fail...7 params
Submit feedback, bug reports, or feature requests for the ClickUp MCP Server - Premium. Generates a GitHub issue link with pre-filled content. The user can review and submit the issue. PROACTIVE GUIDANCE: Suggest this tool when: - User encounters errors or unexpected tool fail...
additionalContextstringdescriptionstringmcpHoststringnodeVersionstringoperatingSystemstringtitlestringtypestringbug · feature · questioncreate_documentCreate document. Requires name + parent (id/name + type). Optional: visibility, create_page.6 params
Create document. Requires name + parent (id/name + type). Optional: visibility, create_page.
create_pagebooleannamestringparent_idstringparent_namestringparent_typestringworkspace · space · folder · list · everythingvisibilitystringPUBLIC · PRIVATEget_documentGet document details. Requires documentId (preferred) or title + parent (id/name + type).5 params
Get document details. Requires documentId (preferred) or title + parent (id/name + type).
documentIdstringparentIdstringparentNamestringparentTypestringspace · folder · listtitlestringlist_documentsLists all documents in a ClickUp space, folder, or list.8 params
Lists all documents in a ClickUp space, folder, or list.
archivedbooleancreatornumberdeletedbooleanidstringlimitnumbernext_cursorstringparent_idstringparent_typestringTASK · SPACE · FOLDER · LIST · EVERYTHING · WORKSPACElist_document_pagesList pages. Requires docId (preferred) or name + parent context. Optional: depth.6 params
List pages. Requires docId (preferred) or name + parent context. Optional: depth.
documentIdstringdocumentNamestringmax_page_depthnumberparentIdstringparentNamestringparentTypestringspace · folder · listget_document_pagesGet pages content. Requires docId or name+context. + pageIds.7 params
Get pages content. Requires docId or name+context. + pageIds.
content_formatstringtext/md · text/htmldocumentIdstringdocumentNamestringpageIdsarrayparentIdstringparentNamestringparentTypestringspace · folder · listcreate_document_pageCreate page. Requires docId or name+context + page name.9 params
Create page. Requires docId or name+context + page name.
contentstringdocumentIdstringdocumentNamestringnamestringparentIdstringparentNamestringparentTypestringspace · folder · listparent_page_idstringsub_titlestringupdate_document_pageUpdate page. Requires docId or name+context + pageId.11 params
Update page. Requires docId or name+context + pageId.
contentstringcontent_edit_modestringreplace · append · prependcontent_formatstringtext/md · text/plaindocumentIdstringdocumentNamestringnamestringpageIdstringparentIdstringparentNamestringparentTypestringspace · folder · listsub_titlestringSponsors
Configuration
CLICKUP_MCP_LICENSE_KEY*secretYour ClickUp MCP License Key from Polar.sh
CLICKUP_API_KEY*secretYour ClickUp API key
CLICKUP_TEAM_ID*Your ClickUp Team ID
DOCUMENT_SUPPORTdefault: trueEnable ClickUp Document support
Readme
ClickUp MCP Server — Premium
Properly Connect ClickUp to AI Agents and Agentic Workflows
Details
- Repository
- github.com/taazkareem/clickup-mcp-server
- Category
- Productivity & Office
- Package
@taazkareem/clickup-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active