Skip to main content

​
Overview

The four tools below change note titles and folder organization.
  • update_note — Update a note’s title. Scope mcp:note:write.
  • update_folder — Update a folder’s title, description, or color. Scope mcp:folder:write.
  • move_folder — Move a folder under a different parent, or to the workspace root. Scope mcp:folder:write.
  • reorder_folders — Reorder sibling folders within their parent. Scope mcp:folder:write.
When to use
  • Rename a note after its meeting so the title reflects what actually happened.
  • Rename a folder, tidy up its description, or recolor it for at-a-glance grouping.
  • Reorganize the folder tree: nest a folder under another, promote it to the workspace root, or change the order siblings appear in.
Account API key vs. workspace API key (folder tools). For update_folder, move_folder, and reorder_folders: an account API key can edit any folder it has edit access to (private or team). A workspace API key can edit only folders shared with all workspace members. Private folders and folders shared with just some members are rejected (see What notes a system API key reads). update_note works with account, workspace, or organization API keys.

​
update_note

Update a note’s title.

​
Parameters

​
Example

Request:
Response:

​
update_folder

Update a folder’s title, description, and/or color. This is an AIP-134 field-mask update: only the fields you pass are changed, and everything you omit is left untouched. At least one field is required.

​
Parameters

At least one of title, description, or color must be provided. Fields you omit are not modified — this lets you change the color without resending the title, for example.

​
Example

Request:
Response:

​
move_folder

Move a folder under a different parent, or to the workspace root.

​
Parameters

​
Example

Request:
Moves folder 12346 under folder 12345. Response:
To move a folder to the workspace root, omit newParentId (or pass null): Request:

​
reorder_folders

Reorder sibling folders. Pass the complete desired order of a single set of siblings; the workspace is inferred from the first folder ID.

​
Parameters

​
Example

Request:
Reorders the three sibling folders so they appear in the given order. Response:

​
Scope Requirements

update_note requires the mcp:note:write scope; update_folder, move_folder, and reorder_folders require the mcp:folder:write scope.
API keys follow the scopes configured on the key — keys without scopes and keys with note:write/folder:write can call these tools. OAuth clients can call them only with a token where read + write was chosen on the consent screen during connection.
Configure your API key at Tiro Platform API Keys.
  • get_note — Read a note’s current metadata before updating its title.
  • Folder search — Find a folder’s folderId by name before editing, moving, or reordering it.
  • get_note_folders — List the folders a note belongs to.