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