ClickUp MCP Server

Instructions

Implementation Reference

• src/clickup_mcp/tools.py:669-719 (handler)

  The primary handler function for the MCP 'update_task' tool. Resolves task ID using _resolve_task_id, constructs UpdateTaskRequest from parameters, calls client.update_task, and returns formatted result.
  async def update_task( self, task_id: str, title: Optional[str] = None, description: Optional[str] = None, status: Optional[str] = None, priority: Optional[int] = None, due_date: Optional[str] = None, assignees_add: Optional[List[int]] = None, assignees_remove: Optional[List[int]] = None, **kwargs: Any, ) -> Dict[str, Any]: """Update task properties.""" try: # First resolve the task to get the internal ID resolved_task = await self._resolve_task_id(task_id) parsed_id = resolved_task.id except ClickUpAPIError as e: return {"error": f"Failed to resolve task '{task_id}': {e!s}"} update_request = UpdateTaskRequest() if title: update_request.name = title if description is not None: update_request.description = description if status: update_request.status = status if priority: update_request.priority = priority if due_date: dt = datetime.fromisoformat(due_date.replace("Z", "+00:00")) update_request.due_date = int(dt.timestamp() * 1000) update_request.due_date_time = True if assignees_add or assignees_remove: update_request.assignees = {} if assignees_add: update_request.assignees["add"] = assignees_add if assignees_remove: update_request.assignees["rem"] = assignees_remove task = await self.client.update_task(parsed_id, update_request) return { "id": task.id, "name": task.name, "status": task.status.status, "updated": True, }
• src/clickup_mcp/tools.py:114-139 (schema)

  JSON schema definition for the 'update_task' tool input parameters, defined in ClickUpTools.get_tool_definitions().
  Tool( name="update_task", description="Update task properties", inputSchema={ "type": "object", "properties": { "task_id": {"type": "string", "description": "Task ID"}, "title": {"type": "string", "description": "New title"}, "description": {"type": "string", "description": "New description"}, "status": {"type": "string", "description": "New status"}, "priority": {"type": "integer", "description": "New priority"}, "due_date": {"type": "string", "description": "New due date"}, "assignees_add": { "type": "array", "items": {"type": "integer"}, "description": "User IDs to add as assignees", }, "assignees_remove": { "type": "array", "items": {"type": "integer"}, "description": "User IDs to remove as assignees", }, }, "required": ["task_id"], }, ),
• src/clickup_mcp/tools.py:23-57 (registration)

  Registration of the 'update_task' handler (and all other tools) in the ClickUpTools._tools dictionary during __init__, used by call_tool.
  self._tools: Dict[str, Callable] = { "create_task": self.create_task, "get_task": self.get_task, "update_task": self.update_task, "delete_task": self.delete_task, "list_tasks": self.list_tasks, "search_tasks": self.search_tasks, "get_subtasks": self.get_subtasks, "get_task_comments": self.get_task_comments, "create_task_comment": self.create_task_comment, "get_task_status": self.get_task_status, "update_task_status": self.update_task_status, "get_assignees": self.get_assignees, "assign_task": self.assign_task, "list_spaces": self.list_spaces, "list_folders": self.list_folders, "list_lists": self.list_lists, "find_list_by_name": self.find_list_by_name, # Bulk operations "bulk_update_tasks": self.bulk_update_tasks, "bulk_move_tasks": self.bulk_move_tasks, # Time tracking "get_time_tracked": self.get_time_tracked, "log_time": self.log_time, # Templates "create_task_from_template": self.create_task_from_template, "create_task_chain": self.create_task_chain, # Analytics "get_team_workload": self.get_team_workload, "get_task_analytics": self.get_task_analytics, # User management "list_users": self.list_users, "get_current_user": self.get_current_user, "find_user_by_name": self.find_user_by_name, }
• src/clickup_mcp/server.py:41-45 (registration)

  MCP server handler for listing tools, which returns definitions including 'update_task' schema from ClickUpTools.get_tool_definitions().
  @self.server.list_tools() async def list_tools() -> List[Tool]: """List all available tools.""" return self.tools.get_tool_definitions()
• src/clickup_mcp/client.py:306-317 (helper)

  ClickUpClient.update_task method: performs the actual API PUT request to /task/{task_id} with UpdateTaskRequest data, used by the tool handler.
  async def update_task( self, task_id: str, updates: UpdateTaskRequest, ) -> Task: """Update a task.""" data = await self._request( "PUT", f"/task/{task_id}", json=updates.model_dump(exclude_none=True), ) return Task(**data)