MCPVault

Lightweight server for safe access to an Obsidian vault folder: read, search, write and tag notes, no plugin needed.

🗂️ Team productivity1,686Updated 2026-10-13By bitbonsaiLicense: MITAuth: NoneGitHub ↗

Found viaWebnpm: @bitbonsai/mcpvault GitHubGitHub: bitbonsai/mcpvault (★ 1686 on 2026-10-15)

Best for team productivity · provisional · tested 2026-10-15

Found the note 'toolpassed fixture' in a local Obsidian-style vault and read back its first line in both Claude Code and Cursor, in 3 calls in total. TurboVault also passed both (5 calls), and Obsidian MCP (StevenStavrakis) passed both (6 calls) but needs Node 22+. Account-based tools (Notion, Atlassian, Slack, Linear) and the Obsidian Local REST API server aren't tested, so this pick covers local Obsidian vaults only.

Test results

Last passed 2026-10-15

Claude CodePassed2026-10-15 · install, connect, tools, agent task

CursorPassed2026-10-15 · install, connect, tools, agent task

Claude DesktopNot tested yet—

ChatGPT (Codex)Not tested yet—

Full result per app: Does it work with Claude Code? · Does it work with Cursor?

Protocol: starts, 18 tools listed · 2026-10-15

Install

claude mcp add mcpvault -- npx -y @bitbonsai/mcpvault /path/to/dir/vault

Run in your terminal. This exact command is what our harness runs in Claude Code; see the results above.

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

Save as .cursor/mcp.json. This exact config is what our harness runs in Cursor; see the results above.

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

Add to claude_desktop_config.json and restart Claude Desktop. Tested on the Linux beta; see the results above.

[mcp_servers.mcpvault]
command = "npx"
args = ["-y", "@bitbonsai/mcpvault", "/path/to/dir/vault"]

Add to ~/.codex/config.toml (shared by the ChatGPT (Codex) CLI and the ChatGPT desktop app; Codex runs inside the ChatGPT desktop app). Tested with the ChatGPT (Codex) CLI bundled in the ChatGPT desktop app; see the results above.

Not connecting? Troubleshooting: Claude Code · Cursor · Claude Desktop · ChatGPT (Codex)

Test history

Date	Check	Result	Version
2026-10-15	Protocol (direct stdio)	Protocol: starts, 18 tools listed	0.16.0
2026-10-15	Claude Code	Passed install, connect, tools, agent task	2.1.296 (Claude Code)
2026-10-15	Cursor	Passed install, connect, tools, agent task	2026.10.14-941492e

Tools seen by our harness (18)

read_notewrite_notepatch_notelist_directorydelete_notesearch_notesmove_notemove_fileread_multiple_notesupdate_frontmatterget_notes_infoget_frontmattermanage_tagsget_vault_statslist_all_tagswiki_linkget_note_outlineread_note_lines