# obsidian-emergent-mcp
Most obsidian MCPs I have seen just re impliment the basic features "read note, write note, search for note by tag/keyword", better, but basically just the same as standard claude code tools.
An MCP server that gives Claude Code deep access to your Obsidian vault. 28 tools for searching, navigating, and analyzing your knowledge graph — structural analysis, semantic retrieval, timeseries tracking, and more.
Your vault becomes a live knowledge base that Claude can read, search, and reason about.
## Install
From inside your Obsidian vault, run:
```bash
curl -fsSL https://raw.githubusercontent.com/Gassandrid/obsidian-emergent-mcp/main/install.sh | bash
```
This installs two Python files into your vault's `.claude/` directory, sets up `.mcp.json`, and installs dependencies. The MCP server starts automatically when you open the vault in Claude Code.
### Requirements
- Python 3.10+
- An Obsidian vault (must have `.obsidian/` directory)
- Claude Code CLI
This tool is only really useful if you are Git versioning your vault, dont use this if you are not.
Smart connections will also add some more behavior. we dont use it for RAG but rather just cosine sim for related notes.
## Tools
### Search & Read
| Tool | What it does |
| -------------- | ---------------------------------------------------------------------------------------------------- |
| `vault_rag` | **Primary retrieval.** Free-text query → TF-IDF + embedding reranking → ranked results with excerpts |
| `vault_search` | Substring search across titles, content, tags — for exact lookups |
| `vault_read` | Read a note's content, tags, and link counts |
### Graph Navigation
| Tool | What it does |
| --------------------- | -------------------------------------------------------- |
| `vault_backlinks` | What links TO this note |
| `vault_forward_links` | What this note links TO |
| `vault_context` | Semantically related notes (embeddings + link proximity) |
| `vault_related` | Structurally related notes (shared neighbors) |
| `vault_hubs` | Most connected notes in the vault |
| `vault_orphans` | Notes with no links in or out |
### Timeseries (git-backed)
| Tool | What it does |
| -------------------------- | ----------------------------------------------------------------------------------------- |
| `vault_attention_flow` | What topics you're focused on — edits grouped by tag/folder with trend detection |
| `vault_topic_timeline` | How a knowledge domain grows over time — edits bucketed by week/month/day |
| `vault_note_history` | Full edit history of a specific note — commits, word counts, link counts at each snapshot |
| `vault_diff` | Structural diff: new/deleted notes, link changes over N days |
| `vault_recent` | Recently modified notes |
| `vault_knowledge_velocity` | Which notes are being edited most |
| `vault_link_weights` | Link strength via co-edit frequency |
### Structure Analysis
| Tool | What it does |
| ---------------------- | ---------------------------------------------------------------- |
| `vault_clusters` | Community detection via label propagation |
| `vault_concept_gaps` | Structural holes: missing notes, stub hubs, bridge gaps |
| `vault_broken_links` | Broken wikilinks with inferred topic tags, filterable |
| `vault_maturity` | Score notes by development maturity (word count, links, recency) |
| `vault_prereq_tree` | Learning dependency tree from a root note |
| `vault_stats` | Global metrics: note/link counts, tag distribution |
| `vault_tags` | Tag frequency with example notes |
| `vault_suggest_links` | Find semantically similar but unlinked note pairs |
| `vault_batch_tag` | Preview bulk tag operations (dry-run only) |
| `vault_open_questions` | Extract unresolved questions, TODOs, unchecked checkboxes |
### Agent Memory
| Tool | What it does |
| --------------------- | ---------------------------------------------------- |
| `vault_journal_write` | Record observations for future sessions |
| `vault_journal_read` | Recall past observations, filterable by tag and time |
---
It is recommended to prompt Claude to update your vault CLAUDE.md file to better utilize these tools.
