obsidian_understand_vault

Analyze and visualize the structure of an Obsidian vault by generating a directory tree and a NetworkX graph of note connections. Includes optional settings for attachments and file types to better understand relationships between .md files and associated resources.

Instructions

Get a comprehensive understanding of the vault structure. Returns: 1. directory tree representation and 2. NetworkX graph of note connections used to understand how different notes (.md) and other files (e.g. images, PDFs, referenced/attached) are connected. Combines filesystem directory structure with note relationship graph between notes (.md files).

Input Schema

Name	Required	Description
`directory_path`	No	Optional path to a subdirectory to analyze, defaults to vault root
`include_attachments_in_graph`	No	Whether to include attachment files (images, PDFs, etc.) in the NetworkX connections graph, excluding attachments in Obsidian. Defaults to True
`include_other_files_in_tree`	No	Whether to show only .md files in the directory tree structure, excluding other file types. Defaults to True

Input Schema (JSON Schema)

{
  "properties": {
    "directory_path": {
      "description": "Optional path to a subdirectory to analyze, defaults to vault root",
      "type": "string"
    },
    "include_attachments_in_graph": {
      "default": true,
      "description": "Whether to include attachment files (images, PDFs, etc.) in the *NetworkX connections graph*, excluding attachments in Obsidian. Defaults to True",
      "type": "boolean"
    },
    "include_other_files_in_tree": {
      "default": true,
      "description": "Whether to show only .md files in the *directory tree structure*, excluding other file types. Defaults to True",
      "type": "boolean"
    }
  },
  "type": "object"
}

Advanced Obsidian MCP Server