MCPVault

Install

npx skillfoxx add mcp/mcpvault

claude mcp add --transport stdio obsidian -- npx @bitbonsai/mcpvault@latest /path/to/your/vault

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

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

code --add-mcp '{"name":"obsidian","type":"stdio","command":"npx","args":["@bitbonsai/mcpvault@latest","/path/to/your/vault"]}'

{
  "servers": {
    "obsidian": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@bitbonsai/mcpvault@latest",
        "/path/to/your/vault"
      ]
    }
  }
}

codex mcp add obsidian -- npx @bitbonsai/mcpvault@latest /path/to/your/vault

[mcp_servers.obsidian]
command = "npx"
args = ["@bitbonsai/mcpvault@latest", "/path/to/your/vault"]

gemini mcp add -s user obsidian npx @bitbonsai/mcpvault@latest /path/to/your/vault

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

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

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

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

{
  "mcp": {
    "obsidian": {
      "type": "local",
      "command": [
        "npx",
        "@bitbonsai/mcpvault@latest",
        "/path/to/your/vault"
      ]
    }
  }
}

{
  "context_servers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "@bitbonsai/mcpvault@latest",
        "/path/to/your/vault"
      ]
    }
  }
}

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

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

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.

Example request

Find the notes about quarterly plans in my vault and put together a short summary

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.

MCP

Transport

stdio

Authentication

not required

Security check

• Reads and modifies note files in the given folder
• Can delete and move notes, though this requires a confirmation path

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.

Related