Vault Knowledge
Turns your Obsidian vault into a queryable knowledge graph with semantic search, contradiction detection, and article retrieval. Ships with three tools: search_concepts uses nomic-embed-text-v1.5 for ranked results, find_contradictions surfaces explicit disagreements between your notes by traversing a six-relation reasoning graph, and get_article pulls full markdown with resolved wikilinks. Works out of the box with a demo vault, then point it at your own by setting VAULT_DB and VAULT_ROOT. Scope is locked to knowledge/ subdirectories at config time so clients can't browse beyond what you expose. Read-only, local-first, runs over stdio with no auth or cloud dependencies.
- tools
- 3
- transport
- STDIO
- last updated
- May 30, 2026
Tools
3 toolsPublic tool metadata for what this MCP can expose to an agent.
search_conceptsSemantically ranked concept/connection articles.
Semantically ranked concept/connection articles.
No parameter schema in public metadata yet.
find_contradictionsActive `contradicts` edges from the reasoning graph.
Active `contradicts` edges from the reasoning graph.
No parameter schema in public metadata yet.
get_articleOne article with frontmatter, body, and resolved wikilinks.
One article with frontmatter, body, and resolved wikilinks.
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 languageReadme
vault-knowledge-mcp
A read-only MCP server that turns an Obsidian vault's typed knowledge graph into three tools any MCP client can call. Most knowledge tools can search. Few can tell you where your own notes disagree with each other. This one traverses a six-relation reasoning graph and surfaces the sharpest edge — contradicts. Local-first, stdio, no auth, no cloud, no native build.
The full reasoning lives in docs/EXPLANATION.md.
Tools
| Tool | Returns |
|---|---|
search_concepts(query, limit=5) | Semantically ranked concept/connection articles. |
find_contradictions(scope='all'|'recent_30d') | Active contradicts edges from the reasoning graph. |
get_article(slug) | One article with frontmatter, body, and resolved wikilinks. |
Try it — zero config
Ships with a synthetic espresso vault, so it works the moment it installs.
{
"mcpServers": {
"vault-knowledge": { "command": "npx", "args": ["-y", "@swins/vault-knowledge-mcp"] }
}
}
Then ask: "find contradictions in the vault."
Point it at your own vault
Details
- Repository
- github.com/seanwinslow28/sw-mcp-vault-knowledge
- Categories
- Documents & Knowledge, Search & Web Crawling
- Package
@swins/vault-knowledge-mcp- Transport
- STDIO
- Registry
- MCP registry, active
More from seanwinslow28
Related Documents & Knowledge MCP servers
View all
Groupdocs Markdown Mcpgroupdocs-markdown/groupdocs.markdown.mcpMCP server for GroupDocs.Markdown — convert documents to Markdown via AI agents.0stars
Mcp Knowledge Gapsonetrueclaude-creator/mcp-knowledge-gapsFind what your knowledge base mentions but doesn't actually explain.0stars
Pdf Report Generatorthemoddedcube/pdf-report-generatorGenerate professional PDF reports from LLM output — cover, TOC, tables, charts, 5 themes.0stars
Obsidianmarkuspfundstein/mcp-obsidianMCP server that interacts with Obsidian via the Obsidian rest API community plugin3.7Kstars
Zoterocookjohn/zotero-mcpProvides local AI access to search, retrieve, and cite items from your Zotero library via Streamable HTTP.784stars