obsidian-rag
A Claude Code plugin that connects your Obsidian vault to Claude through 18 MCP tools, 13 skills, and 2 specialized agents. Semantic search is powered by local embeddings (all-MiniLM-L6-v2) with a LanceDB vector store — everything runs locally with no external API calls.
Features
- Full vault CRUD — read, create, append, move, and edit notes with section-level precision
- Local RAG pipeline — semantic search across your entire vault using local embeddings
- Incremental indexing — only re-embeds changed files, with automatic reindexing after writes
- Daily notes — create, read, and append to daily notes with timestamped log entries
- Link graph — traverse outgoing links, backlinks, and find broken wikilinks
- Frontmatter management — safe YAML frontmatter updates with schema validation
- Skills and agents — higher-level workflows for research, organization, and vault maintenance
Installation
From the marketplace
In Claude Code, run:
/plugin marketplace add thoreinstein/claude-plugins
/plugin install obsidian-rag@thoreinstein-plugins
Manual
git clone https://github.com/thoreinstein/obsidian-rag.git ~/.claude/plugins/obsidian-rag
cd ~/.claude/plugins/obsidian-rag
npm install
The built artifact (dist/index.js) is committed to the repo, so no build step is needed. Native dependencies are automatically installed on first session start when using the marketplace install.
Quick start
- Set your vault path — use
/vault or set OBSIDIAN_VAULT_PATH in your environment
- Build the index — run
/index to build the vector index (incremental updates happen automatically)
- Start using it — ask questions about your notes, create new ones, or use any of the skills below
Tools
Reading and searching
| Tool | Description |
|---|
obsidian_read_note | Read the full content of a note |
obsidian_list_notes | List markdown files in the vault or a subdirectory |
obsidian_search_notes | Search notes by keyword (filename and content) |
obsidian_rag_query | Semantic search across the indexed vault |
obsidian_get_daily_note | Get or create today's daily note |
Writing and editing
| Tool | Description |
|---|
obsidian_create_note | Create a new note (auto-creates parent directories) |
obsidian_append_note | Append text to an existing note |
obsidian_append_daily_log | Append a timestamped entry under a daily note heading |
obsidian_replace_section | Replace the body under a heading |
obsidian_insert_at_heading | Insert content at the beginning or end of a section |
obsidian_replace_in_note | Replace the first occurrence of a text string |
obsidian_update_frontmatter | Update YAML frontmatter (single or batch) |
obsidian_move_note | Move or rename a note |
Links and graph
| Tool | Description |
|---|
obsidian_get_links | Get all outgoing [[wikilinks]] from a note |
obsidian_get_backlinks | Find all notes that link to a given note |
obsidian_get_broken_links | Find wikilinks pointing to non-existent notes |
Index and config
| Tool | Description |
|---|
obsidian_rag_index | Build or rebuild the vector index (incremental by default) |
obsidian_set_vault | Set the default vault path |
Skills
Skills are higher-level workflows invoked with /skill-name in Claude Code.
Core skills
| Skill | Description |
|---|
/obsidian-companion | Guides tool selection and writing strategy for vault operations |
/research | Deep vault research — chains semantic search, note reading, and link traversal to synthesize answers with citations |
/journal | Daily note workflows — view today's entry, add logs, weekly review |
/index | Build or rebuild the vector index |
/vault | Set or change the vault path |
/search | Find notes by keyword or filename |
/links | Explore connections between notes (outgoing links, backlinks) |
Advanced workflow skills
| Skill | Description |
|---|
/cross-linker | Find unlinked mentions across the vault and insert missing [[wikilinks]] with confidence scoring |
/vault-lint | Health audit — frontmatter compliance, stale content, orphaned notes, MOC coverage gaps |
/wiki-ingest | Distill external sources (PDFs, markdown, transcripts) into vault-native notes with provenance tracking |
/compound | Promote cross-project knowledge to a global folder via semantic clustering |
/moc-update | Suggest which Maps of Content a new note belongs in |
/link-audit | Audit link health — broken wikilinks, orphaned notes, semantic link suggestions |
