Provides structural health checks for Obsidian vaults, including broken wikilinks, orphaned notes, and missing frontmatter, with optional auto-repair.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@io.github.ermintoygar/vault-health-mcp Check my vault for broken wikilinks and orphaned notes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
pip install vault-health-mcpRelated MCP server: obsidian-mcp-pro
claude mcp add vault-health -- vault-health-mcp --vault ~/my-vault{
"mcpServers": {
"vault-health": {
"command": "uvx",
"args": ["vault-health-mcp", "--vault", "/path/to/vault"]
}
}
}Tool | Tier | Description |
| Free | Point the server at a vault at runtime |
| Free | Full structural scan: broken links, orphans, missing frontmatter |
| Free | List all structurally disconnected leaf notes |
| Free | List all wikilinks pointing to non-existent files |
| Free | File count, link count, orphan %, frontmatter coverage |
| Pro | Auto-fix safe issues (add-only, never deletes) |
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.
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.jwtLicenses are verified fully offline — no phone-home, no activation server. Get a license: [coming soon — Dodo Payments storefront in verification].
Python 3.10+
An Obsidian vault (any size)
MIT
This server cannot be deployed
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Security scanner for MCP servers. Detect vulnerabilities, prompt injection, and tool poisoning.
Scan any MCP server for tool-poisoning, security, auth & license. Trust score before install.
The official Svelte MCP server providing docs and autofixing tools for Svelte development
