Hebbian Vault
Connects Claude to your Obsidian vault with search that learns from what you actually use. Exposes vault_search (BM25 + personalized PageRank + Hebbian usage scoring via RRF), vault_read for fetching notes with metadata, vault_neighbors for link traversal, and vault_hot to surface frequently accessed files. The Hebbian piece increments retrieval counts on every read, applies recency weighting, and decays stale files so your vault develops usage heatmaps over time. Works directly on the filesystem without Obsidian running. Tracking lives in a .hebbian sidecar directory by default, or inline in YAML frontmatter if you go Pro. Reach for this when keyword search alone misses the pages you keep coming back to, or when you want graph topology to influence ranking.
- tools
- 7
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Apr 18, 2026
Tools
7 toolsPublic tool metadata for what this MCP can expose to an agent.
configure_vaultPoint the server at a vault at runtime (if not set via `--vault`)
Point the server at a vault at runtime (if not set via `--vault`)
No parameter schema in public metadata yet.
vault_searchHybrid ranked search (BM25 + PageRank + Hebbian)
Hybrid ranked search (BM25 + PageRank + Hebbian)
No parameter schema in public metadata yet.
vault_readRead a note with frontmatter, links, and Hebbian metadata
Read a note with frontmatter, links, and Hebbian metadata
No parameter schema in public metadata yet.
vault_neighborsFind connected notes by wikilinks (1-hop or 2-hop)
Find connected notes by wikilinks (1-hop or 2-hop)
No parameter schema in public metadata yet.
vault_hotTop-N most-used files by Hebbian score
Top-N most-used files by Hebbian score
No parameter schema in public metadata yet.
vault_statsVault analytics (files, links, orphans, hubs)
Vault analytics (files, links, orphans, hubs)
No parameter schema in public metadata yet.
vault_healthStructural integrity check (broken links, orphans)
Structural integrity check (broken links, orphans)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
HEBBIAN_VAULT_LICENSEsecretPro license JWT (optional). Unlocks --inline-tracking and other premium features. See the README for details.
Readme
hebbian-vault
MCP server for intelligent, use-adaptive Obsidian vault search.
Your vault remembers what matters. Files you use strengthen. Unused files fade. Hub pages surface first. Search gets better over time.
What it does
Unlike standard Obsidian search (keyword matching), hebbian-vault uses four signals merged via Reciprocal Rank Fusion:
- BM25 -- keyword relevance (like standard search, but ranked)
- Personalized PageRank -- graph centrality biased toward your query (hub pages surface first)
- Hebbian usage -- files you actually use rank higher, with recency decay
- RRF merge -- combines all signals without weight tuning
Works with any Obsidian vault. No cloud. No Obsidian running required. Direct filesystem access.
Install
pip install hebbian-vault
Usage
Claude Code
claude mcp add hebbian-vault -- hebbian-vault --vault ~/my-vault
Details
- Repository
- github.com/onetrueclaude-creator/hebbian-vault
- Categories
- Documents & Knowledge, Search & Web Crawling
- Package
hebbian-vault- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from onetrueclaude-creator
Related Documents & Knowledge MCP servers
View all
Mcp Curiosity Engineonetrueclaude-creator/mcp-curiosity-engineSurface the notes you forgot you wrote — DMN replay for markdown vaults.0starsVault Health Mcponetrueclaude-creator/vault-health-mcpObsidian vault structural health: broken links, orphans, missing frontmatter, safe auto-repair.0stars
Panda Research Toolspandadad0214/panda-research-toolsScholarly integrity — citations, literature/PubMed, experts, PDF tables, Wayback, trends (8 tools).0stars
LeBonFoinpop24/lebonfoin-mcpFirst MCP for the European hemp & CBD market: real French CBD catalogue, producers, FR/EN wiki0stars
Codemeshpyalwin/codemeshIntelligent code knowledge graph for AI coding agents — 71% cheaper, 72% faster0stars
Rarasrarasai/rarasDisease Twin — Brazil's rare-disease knowledge graph (10,468) over MCP. Source-grounded, PT-BR.0stars