MCP.Market

Vault Health MCP server

by onetrueclaude-creator·io.github.onetrueclaude-creator/vault-health-mcp·v0.2.0
No reviews yet

Obsidian vault structural health: broken links, orphans, missing frontmatter, safe auto-repair.

C69/100grade C
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
C69/100

full report

Adoption
New

0 stars17 downloads/wk

Reviews

Write one

Nobody has reviewed Vault Health yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Vault Health tools (6)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • check_vault_health

    Scan the vault for structural issues: broken wikilinks, orphaned notes, missing frontmatter. Returns a categorized list of all issues found.

  • configure_vault

    Configure the vault path for this server. Call this first if the server started without a --vault argument.

  • find_broken_links

    Find all broken wikilinks — [[targets]] that don't resolve to any file in the vault. Excludes wikilinks inside code spans.

  • find_orphans

    Find all orphaned leaf notes — notes typed as 'leaf' in frontmatter that are not linked from any hub or branch file.

  • repair_vault

    [Pro] Auto-repair safe structural issues. Only adds content (frontmatter, plain text replacements for broken links). Never deletes files or content. Requires Pro license.

  • vault_statistics

    Vault-level analytics: file count, link count, orphans, broken links, frontmatter coverage percentage.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan8 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 162 days ago8/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 69/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Vault Health compares

Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
69/100
higher than 28% of 1,299 Productivity servers
Tools
6
the typical Productivity server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
17
more than 4% of 427 Productivity servers with a package

What its tools let an agent do: 6 read

Install Vault Health in Claude Code, Cursor or VS Code

claude mcp add vault-health-mcp -- uvx vault-health-mcp
Add to Cursor

What the publisher says

From the Vault Health repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.onetrueclaude-creator/vault-health-mcp -->

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

How auto-repair works (Pro)

repairvault only makes additive** changes:

  • Broken [[links]] → replaced with plain text (the link text is preserved)
  • Missing frontmatter → adds a default YAML block with title and type

It never deletes files, removes content, or modifies existing frontmatter values.

Pro tier

The free tier detects every category of vault rot. The Pro tier unlocks repair_vault — one call to fix the safe categories automatically.

License activation — any one of these works:

# 1. Environment variable
export VAULT_HEALTH_LICENSE="eyJhbGc..."

# 2. CLI flag
vault-health-mcp --license-key "eyJhbGc..." --vault ~/my-vault

# 3. Config file
echo "eyJhbGc..." > ~/.vault-health-mcp/license.jwt

Licenses are verified fully offline — no phone-home, no activation server. Get a license: [coming soon — Dodo Payments storefront in verification].

Requirements

  • Python 3.10+
  • An Obsidian vault (any size)

License

MIT

Nothing above is checked by us. What we check is on the safety report.

Vault Health: common questions

Is Vault Health MCP server safe?
With care: it is graded C, so read the findings first (69/100). Read the Vault Health safety report
How do I install Vault Health?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Vault Health need an API key?
Yes. The registry entry asks for VAULT_HEALTH_LICENSE.
Is Vault Health maintained?
The last commit was 200 days ago (2026-04-18). The latest release is v0.2.0.
What can I use instead of Vault Health?
Servers from other publishers that do the same job: Obsidian MCP server, Obsidian Hybrid Search MCP server and Seekstone MCP server.
How does Vault Health compare with other Productivity MCP servers?
safety score 69/100 (higher than 28% of 1,299 Productivity servers); tools 6 (the typical Productivity server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Vault Health

Same job from other publishers: the closest match first, then the best rated.

  • Obsidian
    Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.
    A
  • Obsidian Hybrid Search
    Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.
    B
  • Seekstone
    Filesystem-direct Obsidian MCP server — search and edit your vault with low context-tax.
    A
  • Obsidian Vault MCP
    Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes.
    A
  • Obsidian Turbocharged
    Governed Obsidian vault access: hybrid retrieval, Markdown-native memory, HITL confirmations.
    B

More from onetrueclaude-creator →