メインコンテンツへスキップ

​
概要

get_note_folders は逆引きツールです。ノートの GUID を渡すと、そのノートが属するフォルダ一覧を返します。「このノートはどのフォルダに入っているか？」に答えるために使い、フォルダ内のノートを列挙する list_notes の filter.folderId とは逆方向の操作です。 フォルダ検索ツールとは用途が異なります。フォルダ名でフォルダツリーを閲覧・検索したい場合は search_private_folders / search_team_folders を、すでにノートを持っていてそのフォルダ所属を知りたい場合は get_note_folders を使ってください。 主なユースケース:
  • ノートの所在を表示（「このノートは Engineering > Q1 Planning に整理されています」）。
  • 次にどのフォルダ検索ツールを使うか判断：各結果の isTeamFolder フラグで、そのフォルダがチーム（ワークスペース共有）フォルダか個人フォルダかが分かります。

​
パラメータ

パラメータ型必須説明
noteGuidstring必須フォルダ一覧を取得するノートの GUID。

​
レスポンス形式

{
  "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[].folderIdstring安定したフォルダ識別子。
content[].namestringフォルダ名。
content[].workspaceGuidstringフォルダが属するワークスペースの GUID。常に存在（ノートのフォルダは常にワークスペースに属する）。
content[].isTeamFolderbooleanチーム（ワークスペース共有）フォルダなら true、個人フォルダなら false。
totalnumber返されたフォルダ数。
フォルダ一覧はサーバー側でアクセス権限フィルタリングされます。ノートのワークスペースと呼び出し元のメンバーシップを通じて到達可能なフォルダのみが返されます。

​
使用例

リクエスト: 
{
  "noteGuid": "note_abc123"
}
レスポンス: 
{
  "content": [
    { "folderId": "200", "name": "Engineering", "workspaceGuid": "ws_abc123", "isTeamFolder": true }
  ],
  "total": 1
}

​
スコープ要件

get_note_folders は mcp:notes:read と mcp:folders:read の両方のスコープを必要とします。アクセス可能なノートをキーとしますが（notes スコープ）、フォルダのメタデータを返すため（folders スコープ — search_*_folders ツールが必要とするものと同じ）、両方のスコープが必要です。さらにノートのアクセス権限でもゲートされます。ノートを読めない呼び出し元は、そのノートのフォルダも取得できません。API キーはすべてのスコープを含み、OAuth トークンは両方のスコープを付与される必要があります。API キーは Tiro Platform API Keys で設定してください。

​
関連ツール