Get Note Folders

Overview

Pass a note’s GUID to get_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 isTeamFolder flag tells you whether the folder is a team (workspace-shared) folder or a private one.

Parameters

Parameter	Type	Required	Description
`noteGuid`	string	Conditional	The GUID of the note whose folders you want to list.
`url`	string	Conditional	A Tiro note URL used instead of `noteGuid` — a share link (`https://tiro.ooo/s/{shareId}`) or a note web URL (`/n/{noteId}`). Send exactly one of `noteGuid` or `url`.

Response Format

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

Field Descriptions:

Field	Type	Description
`content[]`	array	The folders the note belongs to. Empty when the note is not filed in any folder.
`content[].folderId`	string	Stable folder identifier.
`content[].name`	string	Folder name.
`content[].workspaceGuid`	string	GUID of the workspace the folder belongs to. Always present (a note folder is always workspace-scoped).
`content[].isTeamFolder`	boolean	`true` for a team (workspace-shared) folder, `false` for a private folder.
`total`	number	Number of folders returned.

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:

{
  "noteGuid": "note_abc123"
}

Response:

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

Scope Requirements

get_note_folders requires both the mcp:note:read and mcp:folder:read scopes — because it returns folder metadata (id, name, workspaceGuid, team/private flag) keyed off a note, it needs the same mcp:folder:read as the search_*_folders tools, and because the lookup is tied to a specific note it also needs mcp:note:read. If either scope is missing, the call is rejected. Configure your API key at Tiro Platform API Keys.

list_notes — The forward direction: list the notes inside a folder via filter.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.

Home

Getting Started

API

Voice File

Webhooks

MCP

CLI

Developer Resources

Overview

Parameters

Response Format

Usage Example

Scope Requirements

​Overview

​Parameters

​Response Format

​Usage Example

​Scope Requirements

​Related Tools

Overview

Parameters

Response Format

Usage Example

Scope Requirements

Related Tools