list_folders_tool

List and view the hierarchical structure of folders within your Obsidian vault or a specific directory, aiding in organization, verification, and understanding of folder paths and names.

Instructions

List folders in the vault or a specific directory.

When to use:
- Exploring vault organization structure
- Verifying folder names before creating notes
- Checking if a specific folder exists
- Understanding the hierarchy of the vault

When NOT to use:
- Listing notes (use list_notes instead)
- Searching for content (use search_notes)

Returns:
    Folder structure with paths and names

Input Schema

Name	Required	Description
`ctx`	No
`directory`	No	Specific directory to list folders from (optional, defaults to root)
`recursive`	No	Whether to include all nested subfolders

Input Schema (JSON Schema)

{
  "properties": {
    "ctx": {
      "default": null,
      "title": "Ctx"
    },
    "directory": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Specific directory to list folders from (optional, defaults to root)",
      "examples": [
        null,
        "Projects",
        "Daily",
        "Archive/2024"
      ],
      "title": "Directory"
    },
    "recursive": {
      "default": true,
      "description": "Whether to include all nested subfolders",
      "title": "Recursive",
      "type": "boolean"
    }
  },
  "type": "object"
}

Obsidian MCP Server

list_folders_tool

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Obsidian MCP Server

Related Tools

MCP directory API