M
MCP Directory CURATED DIRECTORY
108 MCP servers indexed
中文
← Back to directory
M

MCPVault

Community
A safe MCP bridge to Obsidian vaults
GitHub source repository ↗
★ 1.6k Stars Category · Filesystem Very popular
60FMRS · C
Reliability
9/20
Security and permissions
13/20
Maintenance
10/20
Documentation
15/20
Setup experience
13/20

MCPVault is an MIT-licensed open-source MCP server for local Obsidian vaults, offering a broad set of note and file-management tools. Its strengths include frontmatter preservation, path security, confirmation for risky operations, and stdio isolation; its main risks are data exposure and unwanted changes when an AI assistant has vault access and write permissions.

Read the FMRS scoring method →

MCPVault is a lightweight MCP server that provides safe read/write access to an Obsidian vault. It supports notes, directories, search, batch reads, metadata, and tag management, with path validation, file filtering, and YAML frontmatter validation to reduce unsafe operations. The server runs within the specified vault root over stdio.

Tools

read_note
Reads a note and parses its frontmatter.
write_note
Writes a note in overwrite, append, or prepend mode.
patch_note
Replaces an exact string inside a note.
delete_note
Deletes a note with path confirmation and optional vault or system trash handling.
move_note
Moves or renames a note.
move_file
Moves or renames a file using binary-safe operations; source and destination confirmation are required.
list_directory
Lists files and directories in the vault while filtering system paths.
read_multiple_notes
Reads up to 10 notes in a batch.
search_notes
Searches note content or frontmatter with multi-word matching and BM25 relevance reranking.
get_frontmatter
Extracts only a note's frontmatter.
update_frontmatter
Updates frontmatter without changing note content.
get_notes_info
Returns note metadata including size, modification time, and frontmatter status.
get_vault_stats
Returns vault note count, folder count, total size, and recent items.
manage_tags
Adds, removes, or lists tags in frontmatter and detects inline tags.

Setup

Install Node.js 18 or later. Run npx @bitbonsai/mcpvault@latest /path/to/your/vault, then add the supplied JSON configuration to a compatible MCP client, replacing the path with the actual Obsidian vault path. The path may be omitted to use the current working directory. Restart the client and test by listing files or reading a note.

claude_desktop_config.json 
{"mcpServers":{"obsidian":{"command":"npx","args":["@bitbonsai/mcpvault@latest","/path/to/your/vault"]}}}
Generate and validate client config

Fit and risk

Best for

  • Users who want to access a local Obsidian vault through multiple MCP clients.
  • Note workflows that need to preserve raw formatting for unmodified frontmatter fields.
  • Knowledge-base users who need local file operations, search, and tag management.

Not for

  • Users without an Obsidian vault or local vault directory.
  • Users seeking a remote network service, cloud-hosted service, or non-MCP integration.
  • Users who do not want an AI assistant to access or modify vault content and structure.

Required permissions

  • Requires Node.js 18 or later.
  • Requires read access to the specified vault; writing, moving, and deleting also require the corresponding write permissions.
  • The server can access allowed `.md`, `.markdown`, `.txt`, `.base`, and `.canvas` files.
  • The AI assistant can see allowed file content, directory structure, and some file metadata.

Risks and side effects

  • The server provides full read/write access within its security boundaries, so incorrect instructions can modify or delete notes.
  • Vault content, structure, and file metadata may be exposed to AI conversations with access.
  • Permanent deletion may be unrecoverable; back up the vault before write operations.
  • Path filtering does not isolate content, so sensitive data in allowed files remains readable.

Troubleshooting

  1. Confirm that Node.js 18 or later is installed and `npx` is available.
  2. Verify the vault path and the user's read/write permissions.
  3. Ensure all paths are relative to the vault root and do not use path traversal to reach external files.
  4. Check the client's configuration path and JSON syntax, then restart the client.
  5. If `.obsidian` files appear, check the client display; the server is designed to filter `.obsidian`, `.git`, `node_modules`, and system files.

Use cases

List, read, and search Obsidian notes through an AI assistant.
Create, append, prepend, or precisely edit note content.
Read notes in batches and inspect vault statistics.
Maintain frontmatter and tags.
Move, rename, or confirmed-delete notes and files.

Supported clients

Claude DesktopFull support
Claude CodeFull support
OpenCodeFull support
Goose DesktopFull support
ChatGPT DesktopPartial support
IntelliJ IDEA 2025.1+Full support
Cursor IDEFull support
Windsurf IDEFull support
OntheiaFull support
Microsoft Copilot StudioFull support
OpenAI CodexFull support

Related MCP servers

Filesystem MCP Server · Secure local file read/write accessobsidian-mcp-server · Manage Obsidian knowledge bases through MCP.mcp-server-filesystem · Restricted filesystem access for MCPMCP for Beginners TypeScript Sample · Learn Model Context Protocol through hands-on, multilingual examples.
Compare with other MCP servers