obsidian-vault

obsidian-vault

A Claude Code plugin that connects Claude to your Obsidian vault. Search, read, create, edit, rename, and list notes with awareness of frontmatter, wikilinks, and vault conventions.

Installation

1. Add the marketplace

claude plugin marketplace add --url https://github.com/dathagerty/obsidian-vault-plugin.git

2. Install the plugin

claude plugin install obsidian-vault@obsidian-vault-marketplace

3. Set your vault path

The plugin reads your vault location from the OBSIDIAN_VAULT_PATH environment variable. Add it to your shell profile (e.g. ~/.zshrc, ~/.bashrc):

export OBSIDIAN_VAULT_PATH="$HOME/path/to/your/vault"

Reload your shell or source the profile, then restart Claude Code.

4. Verify

Run /doctor inside Claude Code. The obsidian-vault MCP server should show as connected.

What it provides

MCP tools

Tool	Description
vault_search	Full-text and frontmatter search across notes
vault_read	Read note content with parsed frontmatter
vault_create	Create new notes with frontmatter defaults
vault_edit	Edit existing notes
vault_rename	Rename/move notes (updates wikilinks)
vault_list	List notes and folders

Skills

Skill	Description
vault-search	Search and explore notes
vault-create	Create new notes
vault-refactor	Rename and reorganize notes (explicit invocation only)
vault-synthesize	Synthesize information from multiple notes

Vault configuration

Optionally create a .claude-vault.json in your vault root to customize behavior:

{
  "readOnlyFolders": ["archive"],
  "defaultCreateFolder": "inbox",
  "dailyNotesFolder": "daily",
  "dailyNotesFormat": "YYYY-MM-DD",
  "frontmatterDefaults": {
    "tags": []
  }
}

Development

cd server
npm install
npm run build
npm test