# 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):

```json
{
  "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](https://github.com/eBrainiac/Obsidian-Brainstorm-MCP)
- **npm:** [obsidian-brainstorm](https://www.npmjs.com/package/obsidian-brainstorm)
- **Issues:** [Report a bug](https://github.com/eBrainiac/Obsidian-Brainstorm-MCP/issues)

---

## License

MIT