Claude MarketplacesSubmit

Vault Health Mcp

onetrueclaude-creator/vault-health-mcp

Scans your Obsidian vault for structural rot and optionally fixes it. The free tier gives you detection tools: broken wikilinks, orphaned notes, missing frontmatter, and vault-wide statistics. The Pro tier adds `repair_vault`, which makes additive-only changes like converting broken links to plain text and adding default YAML frontmatter blocks. No deletions, no content removal. License verification happens offline via JWT. Useful when you've let a vault grow organically for months and want to clean up link decay without manually hunting through hundreds of notes. Works with any Obsidian vault, no plugins required on the Obsidian side.

tools: 6
auth: Secret needed
transport: STDIO
env var: 1
last updated: Apr 18, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

configure_vaultPoint the server at a vault at runtime

Point the server at a vault at runtime

No parameter schema in public metadata yet.

check_vault_healthFull structural scan: broken links, orphans, missing frontmatter

Full structural scan: broken links, orphans, missing frontmatter

No parameter schema in public metadata yet.

find_orphansList all structurally disconnected leaf notes

List all structurally disconnected leaf notes

No parameter schema in public metadata yet.

find_broken_linksList all wikilinks pointing to non-existent files

List all wikilinks pointing to non-existent files

No parameter schema in public metadata yet.

vault_statisticsFile count, link count, orphan %, frontmatter coverage

File count, link count, orphan %, frontmatter coverage

No parameter schema in public metadata yet.

repair_vaultAuto-fix safe issues (add-only, never deletes)

Auto-fix safe issues (add-only, never deletes)

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

VAULT_HEALTH_LICENSEsecret

Pro license JWT (optional). Unlocks the repair_vault auto-fix tool. See the README for details.

Readme

vault-health-mcp

MCP server for Obsidian vault structural health checks.

Find broken wikilinks, orphaned notes, and missing frontmatter — then auto-repair them. Works with any Obsidian vault, no plugins required.

Install

pip install vault-health-mcp

Usage

Claude Code

claude mcp add vault-health -- vault-health-mcp --vault ~/my-vault

Claude Desktop

{
  "mcpServers": {
    "vault-health": {
      "command": "uvx",
      "args": ["vault-health-mcp", "--vault", "/path/to/vault"]
    }
  }
}

MCP Tools

Tool	Tier	Description
`configure_vault`	Free	Point the server at a vault at runtime
`check_vault_health`	Free	Full structural scan: broken links, orphans, missing frontmatter
`find_orphans`	Free	List all structurally disconnected leaf notes
`find_broken_links`	Free	List all wikilinks pointing to non-existent files
`vault_statistics`	Free	File count, link count, orphan %, frontmatter coverage
`repair_vault`	Pro	Auto-fix safe issues (add-only, never deletes)

View the full README on GitHub

Details

Repository: github.com/onetrueclaude-creator/vault-health-mcp
Category: Documents & Knowledge
Package: vault-health-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active

More from onetrueclaude-creator

Related Documents & Knowledge MCP servers

1

Panda Research Toolspandadad0214/panda-research-toolsScholarly integrity — citations, literature/PubMed, experts, PDF tables, Wayback, trends (8 tools).0stars

2

LeBonFoinpop24/lebonfoin-mcpFirst MCP for the European hemp & CBD market: real French CBD catalogue, producers, FR/EN wiki0stars

3

Codemeshpyalwin/codemeshIntelligent code knowledge graph for AI coding agents — 71% cheaper, 72% faster0stars

4

Rarasrarasai/rarasDisease Twin — Brazil's rare-disease knowledge graph (10,468) over MCP. Source-grounded, PT-BR.0stars

5

Adaptive Memory Graphraskolnikovdd/adaptive-memory-graphPersistent memory for Claude via weighted, interconnected knowledge nodes.0stars

6

KnowDriverecourse-software-inc/knowdrive-mcpPrivate, multimodal knowledge store for agents: hybrid search with cited, provenance-backed results.0stars