ノート & フォルダの編集

概要

これら 4 つの書き込みツールを使うと、アシスタントがお客様に代わってノートとフォルダの構成を編集できます。

update_note — ノートのタイトルを更新します。スコープ mcp:notes:write。
update_folder — フォルダのタイトル・説明・色を更新します。スコープ mcp:folders:write。
move_folder — フォルダを別の親の下へ、またはワークスペースのルートへ移動します。スコープ mcp:folders:write。
reorder_folders — 同じ親の下にある兄弟フォルダを並べ替えます。スコープ mcp:folders:write。

使用する場面:

会議後、実際の内容を反映するようにノートのタイトルを付け直すとき。
フォルダ名を変更したり、説明を整理したり、一目でグループがわかるように色を変えたりするとき。
フォルダツリーを再構成するとき: フォルダを別のフォルダの下にネストする、ワークスペースのルートに昇格させる、兄弟フォルダの表示順を変える。

user key と workspace-system key の違い（フォルダツール）。 update_folder、move_folder、reorder_folders の場合: user API key は編集権限を持つフォルダ（個人またはチーム）であれば何でも編集できます。workspace-system API key は TEAM（ワークスペースで共有された）フォルダのみ を編集でき、個人フォルダを編集しようとすると拒否されます。update_note は user・workspace・organization のいずれの API key でも動作します。

update_note

ノートのタイトルを更新します。

パラメータ

Parameter	Type	Required	Description
`noteGuid`	string	Required	更新するノートの GUID。
`title`	string	Required	新しいノートのタイトル。1–100 文字、空白のみは不可。

例

リクエスト:

{
  "noteGuid": "note_9f8c2a1b",
  "title": "Q1 Planning — Kickoff"
}

レスポンス:

{
  "noteGuid": "note_9f8c2a1b",
  "title": "Q1 Planning — Kickoff",
  "updatedAt": "2026-07-14T09:30:00Z"
}

update_folder

フォルダのタイトル・説明・色を更新します。AIP-134 の field-mask による更新で、渡したフィールドのみが変更され、省略したフィールドはそのまま維持されます。少なくとも 1 つのフィールドが必須です。

パラメータ

Parameter	Type	Required	Description
`folderId`	string	Required	更新するフォルダの ID。
`title`	string	Optional	新しいフォルダのタイトル。1–50 文字、空白のみは不可。
`description`	string	Optional	新しい説明。空文字列（`""`）を渡すとクリアされます。
`color`	string	Optional	`#RRGGBB` の hex 文字列で表したフォルダの色。

title、description、color のうち少なくとも 1 つを指定する必要があります。省略したフィールドは変更されません。たとえばタイトルを再送信せずに色だけを変更できます。

例

リクエスト:

{
  "folderId": "12345",
  "title": "Engineering",
  "color": "#4C6EF5"
}

レスポンス:

{
  "folderId": "12345",
  "title": "Engineering",
  "description": "Engineering team notes",
  "color": "#4C6EF5"
}

move_folder

フォルダを別の親の下へ、またはワークスペースのルートへ移動します。

パラメータ

Parameter	Type	Required	Description
`folderId`	string	Required	移動するフォルダの ID。
`newParentId`	string	Optional	新しい親フォルダの ID。`null` を渡すか省略すると、フォルダをワークスペースのルートへ移動します。

例

リクエスト:

{
  "folderId": "12346",
  "newParentId": "12345"
}

フォルダ 12346 をフォルダ 12345 の下へ移動します。 レスポンス:

{
  "folderId": "12346",
  "title": "Q1 Planning",
  "parentId": "12345"
}

フォルダをワークスペースのルートへ移動するには、newParentId を省略します（または null を渡します）。 リクエスト:

{
  "folderId": "12346"
}

reorder_folders

兄弟フォルダを並べ替えます。1 つの兄弟セットの完全な希望順を渡してください。ワークスペースは最初のフォルダ ID から推定されます。

パラメータ

Parameter	Type	Required	Description
`orderedFolderIds`	string[]	Required	希望する兄弟順の全体（最小 1 個の ID）。すべての兄弟がちょうど 1 回ずつ含まれる必要があります。ワークスペースは最初の ID から推定されます。

例

リクエスト:

{
  "orderedFolderIds": ["12347", "12345", "12346"]
}

3 つの兄弟フォルダを指定した順序で並べ替えます。 レスポンス:

{
  "orderedFolderIds": ["12347", "12345", "12346"]
}

スコープ要件

update_note は mcp:notes:write スコープを必要とし、update_folder、move_folder、reorder_folders は mcp:folders:write スコープを必要とします。

API key はすべてのスコープを持つため、有効な API key であればこれらのツールを呼び出せます。mcp:notes:write / mcp:folders:write スコープが意味を持つのは OAuth ベースのクライアント で、この場合は付与されたスコープによって呼び出せるツールが制御されます。

API key は Tiro Platform API Keys で構成してください。

​概要

​update_note

​パラメータ

​例

​update_folder

​パラメータ

​例

​move_folder

​パラメータ

​例

​reorder_folders

​パラメータ

​例

​スコープ要件

​関連ツール

概要

update_note

パラメータ

例

update_folder

パラメータ

例

move_folder

パラメータ

例

reorder_folders

パラメータ

例

スコープ要件

関連ツール