rework-mcp-server

Returns workspace metadata: hierarchy (spaces/folders/lists), members, plan, seats, shared items, custom task types. Use search_member to find a specific member by name/email. Use get_workspace_seats for seat-only queries. DO NOT use to find tasks — use get_workspace_tasks instead.

Get member and guest seat utilization for the workspace (filled, total, empty). Use this for seat-only queries; use get_workspace with include_seats for combined workspace info.

Get plan details for the workspace (plan_name, plan_id). Use this for plan-only queries; use get_workspace with include_plan for combined workspace info.

Create a task. Requires: name + (listId or listName). Use create_bulk_tasks for multiple. Supports subtasks via nested 'subtasks' array (preferred) or 'parent' ID. Supports custom_fields as [{id,value}], assignees as user IDs/emails/names.

Get detailed task info. If a task name is provided do not lookup the task ID, it will be resolved automatically.

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.

Move task to different list or workspace. High-integrity move (ID/history preserving) is used by default. Cross-workspace discovery is automatic: server searches all available workspaces for source and destination. Deep migration (Copy-Delete) is used for cross-workspace moves. IF BLOCKED by plan limits for intra-workspace move, you MUST ask the user for permission to use allowDestructiveFallback.

Duplicate task. Deep duplication (subtasks, checklists, attachments) is enabled by default. Cross-workspace discovery is automatic: specify any target list name and the server will find it.

PERMANENTLY delete task. If a task name is provided do not lookup the task ID, it will be resolved automatically. Cannot be undone.

Get comments on a task, list, or view. context_type defaults to 'task'. Requires task name/ID for task context, list_id/list_name for list context, view_id for view context.

Create a comment on a task, list, or view. context_type defaults to 'task'. Use commentText for markdown or formattedComment for rich text with @mentions.

Edit or resolve a comment. Requires comment_id. Provide commentText or formattedComment to edit content, or resolved to change resolved state.

Delete a comment. Requires comment_id.

Get threaded replies for a comment. Requires comment_id.

Reply to a comment in a thread. Requires comment_id and commentText or formattedComment.

Add an emoji reaction to a comment. Requires comment_id and reaction. Rules: lowercase, no colons, use '+1'/'-1' for thumbs. Examples: 'joy', 'heart', 'tada', 'rocket'.

Remove an emoji reaction from a comment. Requires comment_id and reaction.

Get post subtype IDs for the workspace. comment_type defaults to 'post'.

Create multiple tasks in one list. Supports recursive subtasks via nested 'subtasks' array. Requires: tasks array + (listId or listName). Each task needs name.

Update multiple tasks. Each task needs: taskId or taskName + listName. Options: batch size, concurrency.

Move multiple tasks to one list or workspace. Each task needs: taskId or taskName + listName. Target: targetListId or targetListName. Cross-workspace discovery is automatic: server searches all available workspaces for source and destination. Uses TIML (ID-preserving) by default for intra-workspace. IF BLOCKED by plan limits for intra-workspace move, you MUST ask for permission to use allowDestructiveFallback.

PERMANENTLY delete multiple tasks. Each task needs: taskId or taskName + listName. Cannot be undone.

Search and retrieve multiple tasks from across the entire workspace using broad filters. Optimized for both specific task lookups (via search_query) and broad hierarchy exploration. Best for answering 'What tasks are related to X?' or 'Find the task with ID Y'. For Date custom fields, you can use natural language values like 'today' or '3 days ago'. To filter by a range (e.g., tasks updated between yesterday and tomorrow), use two filters with inequal operators (>= and <=) on the same field ID.

Link two tasks. Requires taskId (preferred) or taskName for both source and target.

Get dependencies/links for a task. Requires taskId (preferred) or taskName.

Remove link between tasks. Requires taskId (preferred) and linkId (target task ID).

Add a dependency between tasks. Requires task + exactly one of: depends_on (task is blocked by another) or dependency_of (task is blocking another). Supports name or ID for all tasks.

Remove a dependency between tasks. Requires task + exactly one of: depends_on or dependency_of matching the existing dependency. Supports name or ID for all tasks.

Add a task to an additional list (Tasks in Multiple Lists). This preserves the task ID and all data (comments, history) across both lists. Useful for cross-project tracking.

Remove a task from a specific list (TIML). This does NOT delete the task, only the association with this list. The task must remain in at least one other list.

Create a new checklist on a task. Requires name + task_id, task_name, or custom_task_id.

Update a checklist's name or its display position. Requires checklist_id.

Permanently remove a checklist from a task.

Add a new item to an existing checklist. Requires checklist_id and name.

Update a checklist item's name, resolution status, or assignment. Requires checklist_id and checklist_item_id.

Permanently remove an item from a checklist. Requires checklist_id and checklist_item_id.

Retrieve lists in a space (folderless) or in a folder. Requires space_id/space_name OR folder_id/folder_name.

Get detailed information about a specific list. Requires list_id or list_name.

Create a new list in a space or folder. Requires name + space_id/space_name or folder_id/folder_name.

Update an existing list's name, content, due date, priority, status/color, or assignee. Requires list_id or list_name.

Permanently remove a list.

Move a list to a different folder or space. Requires list_id or list_name + destination.

Set privacy and permissions on a list. Requires list_id or list_name, private flag, and entries array.

Create a list from a template. Requires: name + (template_id or template_name) + (space_id/space_name or folder_id/folder_name).

List all folders in a space. Requires space_id or space_name. Use archived=true to include archived folders.

Get a folder and its lists. Requires folder_id or folder_name.

Create a new folder in a space. Requires name + space_id or space_name.

Update a folder's name or its configuration settings.

Permanently remove a folder.

Move a folder to a different space. Requires folder_id or folder_name + destination space_id or space_name.

Set privacy and permissions on a folder. Requires folder_id or folder_name, private flag, and entries array.

Create a folder from a template in a space. Requires: name + template_id + (space_id or space_name). Use return_immediately=false to wait for full creation. Supports date remapping and selective content import.

List all spaces in the workspace. Use archived=true to include archived spaces.

Get detailed information about a specific space. Requires spaceId or spaceName.

Create a new space in the workspace. Requires name.

Update an existing space's settings, name, or features. Requires spaceId or spaceName.

Permanently remove a space.

Set privacy and permissions on a space. Requires spaceId or spaceName, private flag, and entries array.

View Goals available in a Workspace. Returns top-level goals and goals organized in folders.

View detailed information about a specific Goal, including its Key Results.

Create a new Goal in a Workspace.

Update an existing Goal's details. Requires goalId or goalName.

Permanently remove a Goal and its Key Results. Requires goalId or goalName.

Add a new Key Result to an existing Goal.

Update an existing Key Result's progress or configuration. Requires keyResultId or keyResultName.

Remove a Key Result from a Goal. Requires keyResultId or keyResultName.

List custom field definitions. Optionally scope by listId/listName, folderId/folderName, spaceId/spaceName, or teamId. Omit all for workspace-level.

Create a custom field definition on a list. Requires listId or listName + name + type.

Set the value of a custom field on a task. Requires taskId or taskName + fieldId or fieldName + value.

Remove the value of a custom field from a task. Requires taskId or taskName + fieldId or fieldName.

List views in a workspace, space, folder, or list. Provide listId, folderId, spaceId, or teamId to scope.

View detailed information about a specific view, including its configuration and filters.

Create a new view. Requires name and type. Provide listId, folderId, or spaceId to set container; omit for workspace level.

Update an existing view's configuration, name, or visibility.

Permanently remove a view.

Retrieve the tasks currently visible in a specific view, respecting its filters and grouping.

List all tags defined in a specific space. Requires spaceId or spaceName.

Create a new tag in a space. Requires tagName + spaceId or spaceName.

Update an existing tag's name or colors in a space. Requires tagName + spaceId or spaceName.

Permanently remove a tag from a space. Requires tagName + spaceId or spaceName.

Add a tag to a specific task. Requires tagName + (taskId or taskName + optional listName). The tag must already exist in the space.

Remove a tag from a task. Requires tagName + (taskId or taskName + optional listName). Only removes the association; the tag remains in the space.

List all chat channels defined in the workspace.

Get detailed information about a specific chat channel. Requires channel_id or channel_name.

Create a new chat channel. Requires name. Optionally provide space_id/folder_id/list_id for location context.

Update an existing chat channel's metadata or visibility. Requires channel_id or channel_name.

Permanently remove a chat channel.

List the members belonging to a specific chat channel. Requires channel_id or channel_name.

List the followers of a specific chat channel. Requires channel_id or channel_name.

Initiate a direct message (DM) channel with specified users. Requires member_ids array.

Retrieve messages from a specific chat channel. Requires channel_id or channel_name.

Post a new message to a chat channel. Requires channel_id or channel_name + content.

Modify an existing chat message or its resolution status. Requires message_id.

Permanently remove a chat message.

Retrieve replies to a specific chat message (threaded chat). Requires message_id.

Post a reply to a chat message. Requires message_id + content.

Add an emoji reaction to a chat message. Requires message_id + reaction emoji name.

Revoke an emoji reaction from a chat message. Requires message_id + reaction emoji name.

List all emoji reactions on a specific chat message. Requires message_id.

List all users who were @mentioned in a specific chat message. Requires message_id.

Get available message subtypes (categories) for a channel.

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 failures - User expresses frustration with missing features or limitations - User asks how to report a bug or request a feature - A tool returns an error that might indicate a bug

Get task templates available in the workspace. Returns template names and IDs for use with create_task_from_template. Optional: page (0-indexed) for pagination.

Create task from a template. Requires: (template_id or template_name) + (list_id or list_name). Optional: task_name to override the default template task name.

List ClickUp documents. Optionally filter by parentId/parentType, creator, deleted, archived.

Get detailed information about a specific document, including its metadata and location.

Create a new document. Requires name and parentType.

List pages in a document. Requires documentId or documentName.

Get a single page from a document. Requires pageId + documentId or documentName.

Get multiple pages from a document by IDs. Requires pageIds array + documentId or documentName.

Create a new page in a document. Requires name + documentId or documentName.

Update a document page. Requires pageId + documentId or documentName.

List all webhooks configured in the workspace.

Create a new webhook to receive real-time notifications from ClickUp. Requires endpoint URL and events array.

Update an existing webhook's endpoint, events, or status.

Permanently remove a webhook.

List all user groups defined in the workspace.

Create a new user group with specified members. Requires group_name and member_ids.

Update a user group's name or its member list. Requires group_id.

Permanently remove a user group from the workspace.

Invite a new guest to the workspace. Requires email address.

Get detailed information about a specific guest by their ID.

Update a guest's display name or their workspace-level permissions.

Permanently remove a guest from the workspace.

Grant a guest access to a specific task.

Revoke a guest's access to a specific task.

Grant a guest access to a specific list.

Revoke a guest's access to a specific list.

Grant a guest access to a specific folder.

Revoke a guest's access to a specific folder.

Get workspace audit logs (Enterprise only). Retrieves security, user, and hierarchy activity. Requires Workspace Owner permissions.

List attachments associated with a task or a file-type custom field. Requires taskId/taskName or customFieldId.

Get detailed information about a specific attachment, including its download URL and metadata.

Upload a file as an attachment to a task or custom field. Supports base64 data, web URLs, or local file paths.

Find the currently active sprint and its tasks. Optionally scoped by space_id or space_name; scans all spaces if omitted.

List all sprints defined in a specific folder. Requires folder_id or folder_name.

Retrieve all tasks belonging to a specific sprint (list). Requires list_id or list_name. Includes TIML tasks by default (tasks added to the sprint via 'Tasks in Multiple Lists').

List time entries for the workspace. Optionally filter by task, list, folder, space, assignees, or date range.

Get the currently running time entry (timer), if any.

Start a time tracking timer on a task. Requires task/taskId/taskName.

Stop the currently running time tracking timer.

Add a manual time entry. Requires task + start_time + duration.

Update an existing time entry's duration, description, or metadata.

Permanently remove a time entry.

Get all time entry tags defined in the workspace.

Add a tag to an existing time entry.

Rename a time entry tag across the entire workspace.

Remove a tag from an existing time entry.

View the modification history of a specific time entry.

Get bulk time-in-status data for multiple tasks.