Overview
Pass a note’s GUID toget_note_folders and it returns the folders that note belongs to. It looks up the opposite direction from list_notes with filter.folderId, which finds the notes inside a folder.
To find folders by name, use search_private_folders or search_team_folders. Use get_note_folders only to find the folders a note belongs to.
When to use
- Show where a note lives (“This note is filed under Engineering > Q1 Planning”).
- Decide which folder-search tool to follow up with: each result’s
isTeamFolderflag tells you whether the folder is a team (workspace-shared) folder or a private one.
Parameters
Response Format
The folder list is access-filtered server-side: only folders reachable by the caller (via the note’s workspace and the caller’s membership) are returned.
Usage Example
Request:Scope Requirements
get_note_folders requires both the mcp:notes:read and mcp:folders:read scopes — it is keyed by an accessible note (notes scope) but returns folder metadata (folders scope, the same scope the search_*_folders tools require). Access is additionally gated by note access: a caller who cannot read the note cannot list its folders. API keys already include all scopes; OAuth tokens must be granted both. Configure your API key at Tiro Platform API Keys.
Related Tools
list_notes— The forward direction: list the notes inside a folder viafilter.folderId.get_note— Get the note’s own metadata and content.search_private_folders/search_team_folders— Search the folder tree by name when you don’t already have a note.