Use this tool to create a folder inside a workspace. Folders help organize boards and docs into logical groups. You can nest folders by specifying a parentFolderId, and customize the folder's appearance with a color, icon, and font weight. After creating a folder, use its returned ID to move boards into it with move_object or nest additional folders.

Parameters

Parameter	Type	Required	Description
workspaceId	`string`	Yes	The ID of the workspace where the folder will be created.
name	`string`	Yes	The name of the folder.
color	`string`	No	The folder's color. 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 font weight of the folder label. One of: `FONT_WEIGHT_BOLD`, `FONT_WEIGHT_LIGHT`, `FONT_WEIGHT_NORMAL`, `FONT_WEIGHT_VERY_LIGHT`, `NULL`.
customIcon	`string`	No	The icon displayed on the folder. One of: `FOLDER`, `MOREBELOW`, `MOREBELOWFILLED`, `NULL`, `WORK`.
parentFolderId	`string`	No	The ID of a parent folder to nest this folder inside. If omitted, the folder is created at the workspace root.

Example

Create a blue folder named "MCP Test Folder" in workspace 12406666:

{
  "workspaceId": "12406666",
  "name": "MCP Test Folder",
  "color": "BRIGHT_BLUE"
}

When tested, this returned: Folder 20393953 successfully created with the name MCP Test Folder. The folder ID (20393953) can then be used with update_folder or move_object.

Programmatic equivalent

Use the GraphQL API to achieve the same result:

mutation {
  create_folder(
    workspace_id: 12406666
    name: "MCP Test Folder"
    color: BRIGHT_BLUE
  ) {
    id
    name
    color
  }
}

For full documentation, see Folders.