Utilizes Git version history within a vault to provide timeseries analysis, tracking knowledge growth, edit trends, and structural changes over time.
Provides deep access to Obsidian vaults for searching, navigating, and analyzing knowledge graphs, including tools for semantic retrieval, structural analysis, and metadata tracking.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@obsidian-emergent-mcpAnalyze my vault and tell me which topics I've been focusing on lately."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
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 |
| Primary retrieval. Free-text query → TF-IDF + embedding reranking → ranked results with excerpts |
| Substring search across titles, content, tags — for exact lookups |
| Read a note's content, tags, and link counts |
Graph Navigation
Tool | What it does |
| What links TO this note |
| What this note links TO |
| Semantically related notes (embeddings + link proximity) |
| Structurally related notes (shared neighbors) |
| Most connected notes in the vault |
| Notes with no links in or out |
Timeseries (git-backed)
Tool | What it does |
| What topics you're focused on — edits grouped by tag/folder with trend detection |
| How a knowledge domain grows over time — edits bucketed by week/month/day |
| Full edit history of a specific note — commits, word counts, link counts at each snapshot |
| Structural diff: new/deleted notes, link changes over N days |
| Recently modified notes |
| Which notes are being edited most |
| Link strength via co-edit frequency |
Structure Analysis
Tool | What it does |
| Community detection via label propagation |
| Structural holes: missing notes, stub hubs, bridge gaps |
| Broken wikilinks with inferred topic tags, filterable |
| Score notes by development maturity (word count, links, recency) |
| Learning dependency tree from a root note |
| Global metrics: note/link counts, tag distribution |
| Tag frequency with example notes |
| Find semantically similar but unlinked note pairs |
| Preview bulk tag operations (dry-run only) |
| Extract unresolved questions, TODOs, unchecked checkboxes |
Agent Memory
Tool | What it does |
| Record observations for future sessions |
| 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.