Vault

About

mcp-vault is a Model Context Protocol (MCP) server that bridges AI assistants with your Obsidian vault. It allows AI models to programmatically interact with your knowledge base, performing operations such as moving and renaming files, extracting and analyzing markdown heading structures, and navigating heading hierarchies with parent chain resolution. The server leverages the Obsidian Local REST API plugin for file manipulations (requiring a custom fork for full functionality) and directly reads markdown files for efficient heading analysis, enhancing AI's ability to manage and understand your vault content.

Key Features

• Move and rename files within an Obsidian vault via the Local REST API (requires custom plugin fork)
• Extract all markdown headings from a specified file with their levels
• Resolve the full parent chain for any given heading, aiding in unambiguous referencing
• Directly reads markdown files for efficient heading analysis
• Integrates with AI assistants through the Model Context Protocol (MCP)
• 1 GitHub stars

Use Cases

• Facilitate AI-driven content patching in Obsidian by generating precise heading targets for modifications.
• Allow AI agents to autonomously organize and refactor files within an Obsidian vault, ensuring backlink integrity.
• Enable AI assistants to quickly grasp the structure of an Obsidian note without processing its full content.