clickup-mcp-pro
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLICKUP_TOKEN | No | Alternative to CLICKUP_API_TOKEN. | |
| CLICKUP_TEAM_ID | No | Default Team/Workspace id used when a tool omits team_id. | |
| CLICKUP_READONLY | No | true blocks all writes (reads still work). | false |
| CLICKUP_API_TOKEN | No | Personal API token (pk_...). CLICKUP_TOKEN is also accepted. | |
| CLICKUP_TIMEOUT_MS | No | Per-request timeout. | 60000 |
| CLICKUP_UPLOAD_DIR | No | Restrict upload_task_attachment(file_path) to this base directory. | |
| CLICKUP_DISABLE_RAW | No | true hides the clickup_raw tool. | false |
| CLICKUP_MAX_RETRIES | No | Max retries on 429/5xx/network errors. | 3 |
| CLICKUP_MAX_UPLOAD_BYTES | No | Max attachment size (50 MB) for uploads. | 52428800 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_workspacesA | List all Teams/Workspaces the authorized token can access, including members. Use this first to discover team_id values. |
| get_workspace_seatsB | Get seat usage (used/total) for a Workspace's members and guests. |
| get_workspace_planB | Get the current plan (name and id) of a Workspace. |
| get_workspace_membersA | List all members (users) of a Workspace with their ids, emails and roles. Useful for resolving assignees. |
| get_custom_task_typesA | List the custom task types defined in a Workspace (e.g. Bug, Feature). |
| get_authorized_userA | Get details of the user that owns the configured API token. |
| list_spacesB | List all Spaces in a Workspace. |
| get_spaceB | Get a single Space by id. |
| create_spaceC | Create a new Space in a Workspace. |
| update_spaceC | Update a Space (name, privacy, assignee mode, features). |
| delete_spaceC | Delete a Space permanently. |
| list_foldersA | List all Folders inside a Space. |
| get_folderB | Get a single Folder by id. |
| create_folderC | Create a Folder inside a Space. |
| create_folder_from_templateB | Create a Folder in a Space from a Folder template. |
| update_folderC | Rename or update a Folder. |
| delete_folderC | Delete a Folder permanently. |
| get_folder_viewsC | List the Views available on a Folder. |
| get_lists_in_folderB | List all Lists inside a Folder. |
| get_folderless_listsB | List all folderless Lists directly under a Space. |
| get_listB | Get a single List by id. |
| create_list_in_folderB | Create a List inside a Folder. |
| create_folderless_listA | Create a List directly under a Space (no Folder). |
| create_list_from_template_in_folderC | Create a List in a Folder from a List template. |
| update_listB | Update a List (name, content, due date, priority, assignee, status). |
| delete_listB | Delete a List permanently. |
| get_list_viewsC | List the Views available on a List. |
| get_tasksB | Get tasks in a List with rich filtering (status, assignees, tags, due/created/updated date ranges, subtasks, custom fields). Paginated. |
| get_taskA | Get a single task by id, including subtasks, custom fields and markdown. |
| get_workspace_tasksA | Filtered/team-wide task search across the whole Workspace (filter by space/folder/list ids, statuses, assignees, tags, due dates). The deep search used when you don't know which list a task is in. |
| create_taskC | Create a task in a List. |
| update_taskB | Update any field of a task. Pass only the fields you want to change. |
| delete_taskA | Delete a task permanently. |
| get_subtasksB | Get the subtasks of a task. |
| duplicate_taskA | Duplicate a task into a target List by reading it and re-creating it (name, description, status, priority, assignees, tags, dates). |
| set_task_custom_field_valueC | Set the value of a custom field on a task. |
| remove_task_custom_field_valueC | Clear/remove a custom field value from a task. |
| get_task_membersC | List the members who have access to a task. |
| create_bulk_tasksA | Create many tasks in a single List at once. Returns per-task success/error so partial failures are visible. |
| update_bulk_tasksB | Apply the same or per-task updates to many tasks at once. |
| delete_bulk_tasksB | Delete many tasks at once. |
| move_bulk_tasksB | Move many tasks into a target List (adds them to the list; uses multi-list association). |
| add_task_linkA | Link two tasks together (non-dependency relationship). |
| delete_task_linkB | Remove a link between two tasks. |
| add_task_dependencyA | Create a dependency between tasks. Provide either depends_on (this task waits on it) or dependency_of (this task blocks it). |
| delete_task_dependencyC | Remove a dependency between tasks. |
| add_task_to_listA | Add an existing task to an additional List (multi-list / 'Tasks in Multiple Lists'). |
| remove_task_from_listB | Remove a task from an additional List (multi-list association). |
| get_task_commentsC | List comments on a task. |
| create_task_commentB | Add a comment to a task. |
| get_list_commentsB | List comments on a List. |
| create_list_commentB | Add a comment to a List. |
| get_chat_view_commentsC | List comments on a Chat view. |
| create_chat_view_commentC | Add a comment to a Chat view. |
| update_commentA | Edit a comment's text, assignee or resolved state. |
| delete_commentC | Delete a comment. |
| get_threaded_commentsC | Get the threaded replies of a comment. |
| create_threaded_commentC | Reply to a comment (threaded). |
| create_checklistB | Create a checklist on a task. |
| edit_checklistC | Rename or reposition a checklist. |
| delete_checklistC | Delete a checklist. |
| create_checklist_itemC | Add an item to a checklist. |
| edit_checklist_itemB | Edit a checklist item (name, assignee, resolved state, parent, nesting). |
| delete_checklist_itemC | Delete a checklist item. |
| upload_task_attachmentA | Attach a file to a task. Provide exactly one source: file_path (local), url (remote file to fetch), or base64 (raw content). file_name is required when using base64. |
| list_task_attachmentsB | List the attachments currently on a task (read from the task object — ClickUp returns attachments inline). |
| get_space_tagsA | List all tags defined in a Space. |
| create_space_tagB | Create a new tag in a Space. |
| update_space_tagB | Update an existing Space tag (rename / recolor). |
| delete_space_tagB | Delete a tag from a Space. |
| add_tag_to_taskC | Add an existing tag to a task. |
| remove_tag_from_taskC | Remove a tag from a task. |
| get_list_custom_fieldsA | List the custom fields available on a List (with their ids and type config). |
| get_folder_custom_fieldsA | List custom fields accessible at the Folder level. |
| get_space_custom_fieldsA | List custom fields accessible at the Space level. |
| get_workspace_custom_fieldsA | List custom fields accessible at the Workspace/Team level. |
| set_custom_field_valueC | Set a custom field value on a task. The |
| remove_custom_field_valueC | Remove/clear a custom field value from a task. |
| get_time_entriesA | List time entries in a Workspace within a date range, optionally filtered by assignee, task, list, folder or space. |
| get_time_entryA | Get a single time entry by id. |
| get_running_time_entryB | Get the currently running timer for a user (or the token owner). |
| start_time_entryC | Start a timer, optionally bound to a task. |
| stop_time_entryA | Stop the currently running timer. |
| create_time_entryB | Create a manual time entry (with explicit start and duration). |
| update_time_entryC | Update a time entry (description, duration, start, billable, tags). |
| delete_time_entryC | Delete a time entry. |
| get_time_entry_historyB | Get the change history of a time entry. |
| get_all_time_entry_tagsA | List all time-entry tags used in a Workspace. |
| add_tags_to_time_entriesB | Add tags to one or more time entries. |
| remove_tags_from_time_entriesC | Remove tags from one or more time entries. |
| get_task_time_in_statusB | Get how long a task has spent in each status. |
| get_bulk_tasks_time_in_statusB | Get time-in-status for multiple tasks at once. |
| search_docsC | Search/list Docs in a Workspace (v3). |
| get_docA | Get a single Doc by id (v3). |
| create_docB | Create a new Doc in a Workspace (v3). |
| get_doc_page_listingA | Get the page tree/listing of a Doc (ids + hierarchy, v3). |
| get_doc_pagesA | Get all pages of a Doc with their content (v3). |
| get_doc_pageA | Get a single Doc page (with content, v3). |
| create_doc_pageB | Create a new page inside a Doc (v3). |
| update_doc_pageB | Update a Doc page. Use content_edit_mode to replace, append or prepend the content (v3). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/helbertparanhos/clickup-mcp-pro'
If you have feedback or need assistance with the MCP directory API, please join our Discord server