obsidian-emergent-mcp
Provides Claude Code with deep access to an Obsidian vault through 28 tools for structural analysis, semantic retrieval, and git-backed timeseries tracking. It transforms your vault into a live knowledge base that Claude can search, navigate, and reason about using its knowledge graph.
README
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:
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.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.