Overview The Folder tools let you browse, create, and manage folder hierarchies for organizing notes. There are two categories of folder tools depending on your API key type.
User Folders (require user-based API key):
list_user_folders - List personal foldersget_user_folder_tree - Get hierarchical folder treeget_user_folder_path - Get breadcrumb path for a folder
Team Folders (require team API key):
list_team_folders - List team foldersget_team_folder_tree - Get team folder treeget_team_folder - Get folder detailsget_team_folder_path - Get breadcrumb pathcreate_team_folder - Create a new folderupdate_team_folder - Update folder propertiesdelete_team_folder - Delete a foldermove_team_folder - Move a folder to a new location
These tools operate on personal folders and require a user-based API key .
list_user_folders Lists personal folders with cursor-based pagination.
Required Scope: mcp:folders:readParameters Parameter Type Required Description cursorstring No Pagination cursor from previous response sizenumber No Number of results per page (max 1000)
Request Example Response { "folders" : [ { "folderId" : 1 , "title" : "Engineering" , "parentId" : null , "createdAt" : "2026-01-15T09:00:00Z" }, { "folderId" : 2 , "title" : "Design Reviews" , "parentId" : 1 , "createdAt" : "2026-02-01T14:30:00Z" } ], "nextCursor" : "eyJpZCI6MTAwfQ==" }
get_user_folder_tree Returns the full hierarchical folder tree structure.
Required Scope: mcp:folders:readParameters Parameter Type Required Description maxDepthnumber No Maximum depth of the tree to return
Request Example Response { "tree" : [ { "folderId" : 1 , "title" : "Engineering" , "children" : [ { "folderId" : 2 , "title" : "Design Reviews" , "children" : [] }, { "folderId" : 3 , "title" : "Sprint Planning" , "children" : [] } ] } ] }
get_user_folder_path Returns the breadcrumb path from root to the specified folder.
Required Scope: mcp:folders:readParameters Parameter Type Required Description folderIdnumber Yes The ID of the folder
Request Example Response { "path" : [ { "folderId" : 1 , "title" : "Engineering" }, { "folderId" : 3 , "title" : "Sprint Planning" }, { "folderId" : 5 , "title" : "Q1 2026" } ] }
These tools operate on shared team folders and require a team API key . Team folders support advanced features like sharing controls and folder colors.
list_team_folders Lists team folders with cursor-based pagination.
Required Scope: mcp:folders:readParameters Parameter Type Required Description cursorstring No Pagination cursor from previous response sizenumber No Number of results per page (max 1000)
Response { "folders" : [ { "folderId" : 10 , "title" : "Product Team" , "description" : "All product meetings" , "color" : "#4A90D9" , "sharingType" : "ALL_MEMBER_VIEWER" , "parentId" : null , "createdAt" : "2026-01-10T08:00:00Z" } ], "nextCursor" : null }
get_team_folder_tree Returns the team folder hierarchy as a tree.
Required Scope: mcp:folders:readParameters Parameter Type Required Description maxDepthnumber No Maximum depth of the tree to return
get_team_folder Gets detailed information about a specific team folder.
Required Scope: mcp:folders:readParameters Parameter Type Required Description folderIdnumber Yes The ID of the folder
Response { "folderId" : 10 , "title" : "Product Team" , "description" : "All product meetings" , "color" : "#4A90D9" , "sharingType" : "ALL_MEMBER_VIEWER" , "parentId" : null , "createdAt" : "2026-01-10T08:00:00Z" , "updatedAt" : "2026-03-20T12:00:00Z" }
get_team_folder_path Returns the breadcrumb path from root to the specified team folder.
Required Scope: mcp:folders:readParameters Parameter Type Required Description folderIdnumber Yes The ID of the folder
create_team_folder Creates a new team folder.
Required Scope: mcp:folders:writeParameters Parameter Type Required Description titlestring Yes Folder name (1-50 characters) descriptionstring No Folder description colorstring No Hex color code (default: #4A90D9) parentIdnumber No Parent folder ID (omit for root level) sharingTypestring No Access level for team members
Sharing Types: Value Description ALL_MEMBER_VIEWERAll team members can view ALL_MEMBER_EDITORAll team members can edit INVITED_ONLYOnly invited members can access
Request Example { "title" : "Q1 2026 Planning" , "description" : "Quarterly planning meetings" , "color" : "#E74C3C" , "parentId" : 10 , "sharingType" : "ALL_MEMBER_EDITOR" }
Response { "folderId" : 15 , "title" : "Q1 2026 Planning" , "description" : "Quarterly planning meetings" , "color" : "#E74C3C" , "sharingType" : "ALL_MEMBER_EDITOR" , "parentId" : 10 , "createdAt" : "2026-03-26T10:00:00Z" }
update_team_folder Updates properties of an existing team folder. Only include the fields you want to change.
Required Scope: mcp:folders:writeParameters Parameter Type Required Description folderIdnumber Yes The ID of the folder to update titlestring No New folder name (1-50 characters) descriptionstring No New description colorstring No New hex color code sharingTypestring No New access level
Request Example { "folderId" : 15 , "title" : "Q1 2026 Planning (Archived)" , "color" : "#95A5A6" }
delete_team_folder Permanently deletes a team folder.
Required Scope: mcp:folders:writeParameters Parameter Type Required Description folderIdnumber Yes The ID of the folder to delete
Request Example Response { "message" : "Folder deleted successfully" }
Deleting a folder is irreversible . Ensure you have moved or backed up any important notes before deleting.
move_team_folder Moves a folder to a new location in the hierarchy.
Required Scope: mcp:folders:writeParameters Parameter Type Required Description folderIdnumber Yes The ID of the folder to move newParentIdnumber No Target parent folder ID (omit to move to root) sharingTypeUpdateStrategystring No How to handle sharing permissions after move
Sharing Update Strategies: Value Description KEEP_EXISTINGKeep the folder’s current sharing settings INHERIT_PARENTInherit sharing settings from the new parent folder
Request Example { "folderId" : 15 , "newParentId" : 20 , "sharingTypeUpdateStrategy" : "INHERIT_PARENT" }
Common Errors Folder Not Found Solution: Verify the folderId is correct using list_user_folders or list_team_folders.Title Too Long Solution: Keep folder titles within the 1-50 character limit.Invalid API Key Type Solution: User folder tools require a user-based API key; team folder tools require a team API key.Best Practices
Use Folder Trees for Navigation
Use get_user_folder_tree or get_team_folder_tree with a limited maxDepth to render navigation UIs efficiently. Avoid deep tree fetches unless the user specifically needs to see the full hierarchy.
Choose Sharing Types Carefully
When creating team folders, consider the sensitivity of the content:
ALL_MEMBER_VIEWER - Good for announcements and read-only resourcesALL_MEMBER_EDITOR - Good for collaborative spacesINVITED_ONLY - Best for confidential or restricted content
Use Breadcrumb Paths for Context
When displaying a folder to a user, use get_user_folder_path or get_team_folder_path to show the full path. This helps users understand where they are in the hierarchy.
Consider Sharing Strategy When Moving
When moving folders, decide whether to KEEP_EXISTING permissions or INHERIT_PARENT. Inheriting is safer when moving folders into a more restricted area.
Next Steps search_notes Find notes within folders
Tools Overview Learn about all available MCP tools
