io.github.onetrueclaude-creator/vault-health-mcp

vault-health-mcp

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

6 tools GitHub PyPI

No known CVEs

No license

Maintained

Last commit 74d ago

Works with most clients

Transport: stdio

6 tools · ~269 tok

Grade A · 0.1% of 200K ctx

Edit this pageView history

Productivity Developer Tools

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-onetrueclaude-creator-vault-health-mcp)](https://mcppedia.org/s/io-github-onetrueclaude-creator-vault-health-mcp)

Read me

What io.github.onetrueclaude-creator/vault-health-mcp does

MCP server for Obsidian vault structural health checks.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'vault-health-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

82/100across 5 weighted dimensions

How we score →

0255075100

−18

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked vault-health-mcp against OSV.dev.

Inventory

Tools (6)

Click any tool to inspect its schema.

~269 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.onetrueclaude-creator/vault-health-mcp safe to use?: io.github.onetrueclaude-creator/vault-health-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.onetrueclaude-creator/vault-health-mcp?: io.github.onetrueclaude-creator/vault-health-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.onetrueclaude-creator/vault-health-mcp do?: io.github.onetrueclaude-creator/vault-health-mcp provides 6 tools: configure_vault, check_vault_health, find_orphans, find_broken_links, vault_statistics and 1 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.onetrueclaude-creator/vault-health-mcp?: io.github.onetrueclaude-creator/vault-health-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.onetrueclaude-creator/vault-health-mcp actively maintained?: io.github.onetrueclaude-creator/vault-health-mcp is recently maintained — last commit was 74 days ago.

Similar servers

Others in productivity / developer-tools

View all →

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

87.9k 1

Memory MCP Server98

Persistent memory using a knowledge graph

87.9k 5

Filesystem MCP Server98

Read, write, and manage files on the local filesystem

87.9k 7

XcodeBuildMCP97

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0k 2

MCP Security Weekly

Get CVE alerts and security updates for io.github.onetrueclaude-creator/vault-health-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

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)

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].

Frequently Asked Questions

Is io.github.onetrueclaude-creator/vault-health-mcp safe to use?

io.github.onetrueclaude-creator/vault-health-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.onetrueclaude-creator/vault-health-mcp?

io.github.onetrueclaude-creator/vault-health-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.onetrueclaude-creator/vault-health-mcp do?

io.github.onetrueclaude-creator/vault-health-mcp provides 6 tools: configure_vault, check_vault_health, find_orphans, find_broken_links, vault_statistics and 1 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.onetrueclaude-creator/vault-health-mcp?

io.github.onetrueclaude-creator/vault-health-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is io.github.onetrueclaude-creator/vault-health-mcp actively maintained?

io.github.onetrueclaude-creator/vault-health-mcp is recently maintained — last commit was 74 days ago.

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)

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