ノートのフォルダ取得

概要

get_note_folders にノートの GUID を渡すと、そのノートが属するフォルダを返します。フォルダ内のノートを探す list_notes の filter.folderId とは逆方向の検索です。フォルダ名で探す場合は search_private_folders または search_team_folders を使ってください。ノートが属するフォルダを探すときだけ get_note_folders を使います。 使うとき

ノートの所在を表示（「このノートは Engineering > Q1 Planning に整理されています」）。
次にどのフォルダ検索ツールを使うか判断：各結果の isTeamFolder フラグで、そのフォルダがチーム（ワークスペース共有）フォルダか個人フォルダかが分かります。

パラメータ

パラメータ	型	必須	説明
`noteGuid`	string	条件付き	フォルダ一覧を取得するノートの GUID。
`url`	string	条件付き	`noteGuid` の代わりに使う Tiro ノートの URL。共有リンク（`https://tiro.ooo/s/{shareId}`）またはノートの Web URL（`/n/{noteId}`）を指定できます。`noteGuid` と `url` はいずれか一方のみを送ってください。

レスポンス形式

{
  "content": [
    { "folderId": "12345", "name": "Project Discussion", "workspaceGuid": "ws_abc123", "isTeamFolder": true },
    { "folderId": "12346", "name": "Daily Standup", "workspaceGuid": "ws_abc123", "isTeamFolder": false }
  ],
  "total": 2
}

フィールド説明:

フィールド	型	説明
`content[]`	array	ノートが属するフォルダ一覧。どのフォルダにも整理されていない場合は空配列。
`content[].folderId`	string	安定したフォルダ識別子。
`content[].name`	string	フォルダ名。
`content[].workspaceGuid`	string	フォルダが属するワークスペースの GUID。常に存在（ノートのフォルダは常にワークスペースに属する）。
`content[].isTeamFolder`	boolean	チーム（ワークスペース共有）フォルダなら `true`、個人フォルダなら `false`。
`total`	number	返されたフォルダ数。

フォルダ一覧はサーバー側でアクセス権限フィルタリングされます。ノートのワークスペースと呼び出し元のメンバーシップを通じて到達可能なフォルダのみが返されます。

使用例

リクエスト:

{
  "noteGuid": "note_abc123"
}

レスポンス:

{
  "content": [
    { "folderId": "200", "name": "Engineering", "workspaceGuid": "ws_abc123", "isTeamFolder": true }
  ],
  "total": 1
}

スコープ要件

get_note_folders は mcp:note:read と mcp:folder:read の両方を必要とします — ノートを基準にフォルダのメタデータ（id、名前、workspaceGuid、チーム／個人の別）を返すため、search_*_folders ツールと同じ mcp:folder:read が必要で、取得が特定のノートに紐づいているため mcp:note:read も併せて必要です。2 つの scope のいずれかが欠けていると呼び出しは拒否されます。API キーは Tiro Platform API Keys で設定してください。

ホーム

はじめに

API

音声ファイル

Webhook

MCP

CLI

開発者リソース

ノートのフォルダ取得

概要

パラメータ

レスポンス形式

使用例

スコープ要件

関連ツール

​概要

​パラメータ

​レスポンス形式

​使用例

​スコープ要件

​関連ツール

概要

パラメータ

レスポンス形式

使用例

スコープ要件

関連ツール