mcpvault

Level ALocal

A lightweight Model Context Protocol (MCP) server for safe Obsidian vault access

Overview

MCPVault is a lightweight local MCP server that lets compatible AI clients read, search, and edit notes in an Obsidian vault. It works directly with vault files—no Obsidian app or plugin required—and confines file operations to the configured vault root, blocking path traversal, symlink escapes, and access to .obsidian, .git, and similar directories. It offers 18 tools for note and file operations, partial and batch reads, search with BM25 reranking, frontmatter and tag management, and wiki link…

⭐ 1.7kOffice & ProductivityTypeScriptRepo ↗Updated 2026-11-16

Installation

MCP client config (paste into mcp.json)

{
  "mcpServers": {
    "bitbonsai-mcpvault": {
      "command": "npx",
      "args": [
        "-y",
        "@bitbonsai/mcpvault@latest",
        "/path/to/your/vault"
      ]
    }
  }
}

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/bitbonsai/mcpvault

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "bitbonsai-mcpvault": {
      "command": "npx",
      "args": [
        "-y",
        "@bitbonsai/mcpvault@latest",
        "/path/to/your/vault"
      ]
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers