Use this tool to modify an existing folder's properties. You can rename it, change its visual appearance (color, icon, font weight), reposition it relative to another object, or move it into a different parent folder or workspace. Only folderId is required—all other fields are optional and only provided fields will be updated.

Note: Positioning parameters (position_object_id, position_object_type, position_is_after) must be provided together. If you provide position_object_id, you must also provide position_object_type, and vice versa.

Parameters

Parameter	Type	Required	Description
folderId	`string`	Yes	The ID of the folder to update.
name	`string`	No	The new name for the folder.
color	`string`	No	The new color for the folder. One of: `AQUAMARINE`, `BRIGHT_BLUE`, `BRIGHT_GREEN`, `CHILI_BLUE`, `DARK_ORANGE`, `DARK_PURPLE`, `DARK_RED`, `DONE_GREEN`, `INDIGO`, `LIPSTICK`, `NULL`, `PURPLE`, `SOFIA_PINK`, `STUCK_RED`, `SUNSET`, `WORKING_ORANGE`.
fontWeight	`string`	No	The new font weight for the folder label. One of: `FONT_WEIGHT_BOLD`, `FONT_WEIGHT_LIGHT`, `FONT_WEIGHT_NORMAL`, `FONT_WEIGHT_VERY_LIGHT`, `NULL`.
customIcon	`string`	No	The new icon for the folder. One of: `FOLDER`, `MOREBELOW`, `MOREBELOWFILLED`, `NULL`, `WORK`.
parentFolderId	`string`	No	The ID of the new parent folder to nest this folder inside.
workspaceId	`string`	No	The ID of the workspace containing the folder. Required when moving the folder to a different workspace.
accountProductId	`string`	No	The account product ID to associate with the folder.
position_object_id	`string`	No	The ID of an object to position this folder relative to. Must be paired with `position_object_type`.
position_object_type	`string`	No	The type of object used as the positioning reference. One of: `Board`, `Folder`, `Overview`. Must be paired with `position_object_id`.
position_is_after	`boolean`	No	If `true`, positions the folder after the reference object. If `false`, positions it before.

Example

Rename folder 20393953 and change its color to purple:

{
  "folderId": "20393953",
  "name": "MCP Test Folder (Updated)",
  "color": "PURPLE"
}

When tested, this returned: Folder 20393953 updated with the new name MCP Test Folder (Updated). The color change was applied immediately and all unspecified fields remained unchanged.

Programmatic equivalent

Use the GraphQL API to achieve the same result:

mutation {
  update_folder(
    folder_id: 20393953
    name: "MCP Test Folder (Updated)"
    color: PURPLE
  ) {
    id
    name
    color
  }
}

For full documentation, see Folders.