MCPVault
A local MCP server for safe read, search and edit of notes in an Obsidian vault, restricted to the vault root
- 1,721 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads and modifies note files in the given folder
- Can delete and move notes, though this requires a confirmation path
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcpvaultDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads and modifies note files in the given folder
- Can delete and move notes, though this requires a confirmation path
This is third-party code. Review the repository files before installing.
What it does
MCPVault runs as a local stdio process and gives an MCP client access to an Obsidian notes folder. It exposes eighteen tools: read, write, patch, delete and move for notes and files, partial reads and note outline, directory and batch reads, search with multi-word matching and BM25 reranking, frontmatter and tag operations and wiki link resolution. Frontmatter edits are format-aware and preserve the layout of unchanged YAML fields. Operations are restricted to the vault root: the server blocks path traversal, symlinks, dotfiles and service directories such as .obsidian, .git and node_modules. Delete and move require a matching confirmation path. Obsidian does not need to be running and no plugin is required.
Who it is for. For people who keep a knowledge base in Obsidian and want to read and edit notes through an AI assistant with restricted access.
Good fit when
- You want the assistant to search and read notes in an Obsidian vault
- You want to create and edit notes while preserving frontmatter
- You need access to notes without running Obsidian and without its plugins
Not a fit when
- You have no local Obsidian-style notes folder
- You need cloud note access rather than local files
Example request
Find the notes about quarterly plans in my vault and put together a short summaryMCP
- Transport
- stdio
- Authentication
- not required
Limitations
The server works with local files and needs Node.js 20 or newer. Access is strictly limited to the given vault root. Delete and move run only with a matching confirmation path. The server itself has no network integrations, so availability depends only on the client.
How to disable. Remove the obsidian entry from your client's MCP configuration and restart it.
FAQ
Does it need a running Obsidian or its plugin?
No. MCPVault works directly with the vault files, Obsidian does not need to run.
Can the server go outside the notes folder?
No. Operations are limited to the vault root, and traversal, symlinks and service directories are blocked.
Discussion
No questions or reviews yet.
Related
MCP serversObsidian MCP Server
obsidian-mcp-server
An MCP server for an Obsidian vault: read, search and precisely edit notes, sections, frontmatter and tags
Obsidian MCP
obsidian-mcp
A local MCP server for Obsidian vaults: reads and edits explicitly configured folders of Markdown files, Obsidian need not be open
An MCP server for an Obsidian vault via the Local REST API plugin: search, read, append and patch notes
A Rust MCP server for Obsidian vaults: search, link graph, note edits guarded by hash checks and rollback from an audit log.
An Obsidian plugin with built-in MCP: agents read, search and edit files on cloud drives while notes stay in sync.
Obsidian plugin with a REST API and a built-in MCP server: an agent reads, searches and surgically edits vault notes from Claude Code or Cursor
README in short
The README describes MCPVault as a local MCP server that lets compatible clients read, search and edit notes in an Obsidian vault while restricting operations to the vault root. The client starts the server as a local stdio process and passes the folder path, and the same tools are available to every supported client. It ships config examples for Claude Desktop, Claude Code, ChatGPT Desktop, OpenCode, Gemini CLI, Codex, IntelliJ IDEA, Cursor, Windsurf and Ontheia. Eighteen tools cover file operations, partial reads, search with BM25 reranking, frontmatter, tags and wiki links, with delete and move requiring a confirmation path. The package is published to npm, MIT licensed.