Skip to main content
Glama
Sign In
obsidian-emergent-mcp

obsidian-emergent-mcp

by Gassandrid
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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.

Related MCP server: obsidian-mcp

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • obsidian-mcp

      bbdaniels
      A
      license
      A
      quality
      C
      maintenance
      Enables Claude Code read/write access to an Obsidian vault, including creating, editing, searching, and browsing notes.
      8
      MIT

    • obsidian-vault-mcp

      Adaptive-Edge
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to read, write, search, and manage an Obsidian vault with tools for notes, tags, folders, and full-text search.
      21 npm
      MIT

    • vault-ask

      burakozg
      A
      license
      Not graded
      quality
      B
      maintenance
      Lets Claude Code and Claude Desktop retrieve and explore an Obsidian vault through tools for semantic search, reading notes, following graph neighbors, and listing topics.
      MIT