mcpField
V
vault-health-mcp

vault-health-mcp

Local
github.com/onetrueclaude-creatorMemory & Knowledge0Updated 28w ago
Repository

About vault-health-mcp

vault-health-mcp is an MCP server for checking and maintaining Obsidian vault structure. It finds broken wikilinks, orphaned notes, and missing frontmatter, with an optional repair tool that only makes additive changes.

Key features

  1. 01Scan for broken wikilinks
  2. 02Find orphaned notes
  3. 03Detect missing frontmatter
  4. 04Report vault statistics
  5. 05Safely repair selected issues

Use cases

  1. 01Audit a vault for broken links
  2. 02Locate disconnected notes
  3. 03Review frontmatter coverage
  4. 04Add safe fixes without deleting content

MCP support

Exposes vault configuration, health checks, issue searches, statistics, and repair as tools for MCP clients. The repair tool is a Pro feature and only adds or substitutes content; it does not delete files or remove existing content.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "onetrueclaude-creator-vault-health": {
      "command": "uvx",
      "args": [
        "vault-health-mcp"
      ],
      "env": {
        "VAULT_HEALTH_LICENSE": "<VAULT_HEALTH_LICENSE>"
      }
    }
  }
}
Run commanduvx vault-health-mcp
Environment variables to set
VAULT_HEALTH_LICENSESecretPro license JWT (optional). Unlocks the repair_vault auto-fix tool. See the README for details.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypivault-health-mcp0.2.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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

ToolTierDescription
configure_vaultFreePoint the server at a vault at runtime
check_vault_healthFreeFull structural scan: broken links, orphans, missing frontmatter
find_orphansFreeList all structurally disconnected leaf notes
find_broken_linksFreeList all wikilinks pointing to non-existent files
vault_statisticsFreeFile count, link count, orphan %, frontmatter coverage
repair_vaultProAuto-fix safe issues (add-only, never deletes)

How auto-repair works (Pro)

repair_vault 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.