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

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

0 tools GitHub

No known CVEs

No license

Maintenance unknown

No commit data

Untested

Transport: stdio

0 tools

Grade F

AI / ML Productivity

Step 1

Install in your client

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

Untested on Claude Desktopstdio · Node 18+

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

{
  "mcpServers": {
    "io-github-onetrueclaude-creator-vault-health-mcp": {
      "command": "<see-readme>",
      "args": []
    }
  }
}

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

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

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

Loading README…

Scored, not listed

Why this score

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

Score breakdown

14/100across 5 weighted dimensions

How we score →

0255075100

−86

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Help improve this page

This server is missing a description. Tools and install config are also missing.If you've used it, help the community.

Add information

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 can be installed by cloning its GitHub repository and following the setup instructions in the README.
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, and most MCP clients that support stdio transport. It uses stdio transport.

Similar servers

Others in ai-ml / productivity

View all →

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

84.1k 1

XcodeBuildMCP97

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

5.3k 1

XcodeBuildMCP96

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

5.3k 2

Scrumboy95

a self-hosted project management & Kanban solution + Instant shareable boards

192 1

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 can be installed by cloning its GitHub repository and following the setup instructions in the README.

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, and most MCP clients that support stdio transport. It uses stdio transport.

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