Obsidian Brainstorm

Connect Claude to your Obsidian vault. Read notes, search your knowledge graph, capture ideas to your daily note, explore backlinks, filter by tags, and more — all from Claude Desktop.

---

Quickstart

Add this to your claude_desktop_config.json (replace the path with your vault):

{
  "mcpServers": {
    "obsidian-brainstorm": {
      "command": "npx",
      "args": ["-y", "obsidian-brainstorm"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "C:/Users/you/Documents/MyVault"
      }
    }
  }
}

Restart Claude Desktop. That's it — no installation required.

Windows users (non-technical): double-click setup.ps1 for a graphical setup wizard with a folder picker and multi-vault manager.

---

What you can do

Ask Claude things like:

• "List my recent notes from the last 3 days"
• "Search my vault for anything about machine learning"
• "What notes link to my 'Project Alpha' note?"
• "Add this to today's daily note: remember to call Alice"
• "Show me all notes tagged #project"
• "Create a new note in Ideas/ about..."
• "Give me stats on my vault"

---

Tools

Tool	Description
get_vault_info	Active vault name and path
get_vault_stats	Note count, word count, top linked notes, folder breakdown, tag count
list_vaults	All configured vaults (multi-vault support)
switch_vault	Switch active vault by name
list_folders	All folders in the vault
list_notes	All notes, optionally filtered by folder
read_note	Full content of a note (auto-truncates at 100KB)
create_note	Create a new note
update_note	Replace a note's content
append_to_note	Append text to an existing note
move_note	Move or rename a note
delete_note	Safe delete (moves to .trash)
search_notes	Full-text search with context snippets
search_by_frontmatter	Find notes by YAML property (e.g. status: active)
list_tags	All tags in vault, sorted by frequency
get_notes_by_tag	Notes containing a specific tag
get_outgoing_links	[[wikilinks]] a note points to
get_backlinks	All notes that link to a given note
get_today_note	Today's daily note (creates if missing, respects your Daily Notes settings)
append_to_today	Quick capture to today's daily note
get_recent_notes	Notes modified in the last N days

Resources

Notes are also exposed as MCP Resources (obsidian-brainstorm://VaultName/path/to/note.md), letting MCP clients browse your vault like a file explorer.

---

Multi-vault

Store multiple vaults in %APPDATA%/obsidian-brainstorm/config.json and switch between them with switch_vault. The OBSIDIAN_VAULT_PATH environment variable always takes priority, making it easy to point different Claude projects at different vaults.

---

Requirements

• Node.js 18+
• Claude Desktop
• An Obsidian vault

---

Links

• GitHub: eBrainiac/Obsidian-Brainstorm-MCP
• npm: obsidian-brainstorm
• Issues: Report a bug

---

License

MIT