v1.5.0 — Reliability, truthful metrics, and cross-vault integrity

An npm/server reliability and cross-vault integrity release focused on truthful operational signals and dependable live behavior.

Highlights

• Truthful vault metrics — indexing status now separates Markdown file coverage, stale indexed paths, embedding chunk count, and chunk density.
• Accurate broken-link reporting — health responses distinguish physical link occurrences from unique unresolved targets and preserve occurrence coordinates.
• Reliable graph authority — graph-bearing responses expose exact-versus-approximate provider state, and caches recover automatically from filesystem fallback when Obsidian becomes available.
• Read-only cross-vault visibility — validated obsidian://open note links can be inventoried and composed into a bounded, typed graph overlay without changing same-vault ranking.
• Filesystem safety hardening — sensitive read paths verify opened file handles against their intended in-vault paths to reduce symlink-swap and TOCTOU risk.
• Stronger release evidence — strict live validation now requires real Obsidian and Ollama execution, while npm verification exercises clean installation, native SQLite loading, MCP startup, and the complete tool surface.

Runtime and installation

Mycelium for Obsidian 1.5.0 requires Node.js 20 or newer.

npm install -g @wickedevolutions/mcp-obsidian@1.5.0

The installed command is mcp-obsidian.

Distribution scope

This is an npm/server release. No MCPB file is attached. The existing v1.4.0 MCPB remains a separate, older distribution and does not contain the 1.5.0 runtime.

Full details are in the CHANGELOG.

v1.4.0 — Graph orientation + retrieval + safety + slash commands

A two-pillar release: graph orientation (the vault's link graph) alongside semantic retrieval (embeddings).

Highlights

• Graph orientation — analyze_link_hierarchy ranks your vault's link graph into hub→leaf structural levels (Obsidian-authoritative when the app is running).
• Graph-aware search — every semantic_search hit carries its structural role; extended cross-vault.
• Hybrid retrieval — RRF fusion + an eval harness; opt-in reranker + HyDE (default OFF).
• Slash commands — /orient, /search, /excluded, /vault-health, /get-started.
• Safety / trust surface — read-only mode, untrusted-content markers, per-tool annotations.
• Concept-link visibility — honest reporting for vaults that link concepts before creating notes.

Full details in the CHANGELOG.

Install

• Claude Desktop (one-click): download mcp-obsidian-1.4.0.mcpb below, double-click, enter your vault paths. (macOS Apple Silicon; bundles the native module. Other platforms: use npm.)
• npm (all platforms): npm install -g @wickedevolutions/mcp-obsidian

v1.3.0 — Mycelium for Obsidian

Mycelium for Obsidian — v1.3.0

• Orientation: get_started + discover_tools map the server's 102 tools (74 filesystem + 28 CLI) up front.
• Schema legibility: configured vault names appear as an enum in every tool's input schema.
• Self-correcting resolution: an unknown vault or note name returns closest-match suggestions ("did you mean …?") instead of a bare error.
• Comprehensive per-tool test coverage + 4 bug fixes (analytics duplicate-basename backlinks; #-anchor/^-block link handling; resolveFile vault-wide lookup; semantic index_vault counter).

Install

• npm (all platforms): npm i -g @wickedevolutions/mcp-obsidian
• One-click .mcpb: macOS (Apple Silicon) only — other platforms use npm. Cross-platform bundle tracked in #12.

Full changelog: CHANGELOG.md

v1.2.0 — 72% of tools now work without Obsidian running

mcp-obsidian v1.2.0

Major architecture shift: 72% of tools now work without Obsidian running.

Before: 32 always-available + 70 CLI-only = 102 tools (31% headless)
After: 72 always-available + 28 CLI-only = 100 tools (72% headless)

What changed

40 tools that previously required the Obsidian CLI have been reimplemented using pure filesystem access — reading .obsidian/ config files and parsing markdown directly. These now work whether Obsidian is running or not.

Promoted to filesystem tier:

• Daily notes (4) — reads .obsidian/daily-notes.json for config
• Tasks (2) — scans markdown checkboxes
• Tags (2) — scans frontmatter + inline #tags
• Properties (5) — read, set, remove, list, get values via frontmatter parsing
• Structure (3) — outline, word count, aliases
• File operations (5) — append, prepend, search/replace, rename, move
• Metadata (4) — file info, folder info, list folders, vault info
• Bookmarks (2) — reads/writes .obsidian/bookmarks.json
• Search with context (1) — regex search with line numbers
• Plugins read-only (3) — reads .obsidian/community-plugins.json and plugin manifests
• Snippets & themes read-only (3) — scans .obsidian/snippets/ and .obsidian/themes/
• Analytics (3) — orphans, deadends, unresolved links
• Workspace (1) — parses .obsidian/workspace.json
• Bases list (1) — scans for .base files
• Random note (1) — filesystem glob + random pick

Still CLI-only (28 tools):
eval, commands, base queries/create, plugin enable/disable, snippet enable/disable, theme set, sync status/history/read, version history/diff/restore, recents, vault discovery, templates with variable resolution, hotkeys, enabled snippets list

Install

Claude Desktop: download mcp-obsidian-1.2.0.mcpb below, double-click.

Claude Code:

claude mcp add -e OBSIDIAN_VAULTS='{"My Vault":"/path/to/vault"}' obsidian -- npx @wickedevolutions/mcp-obsidian

npm:

npm install -g @wickedevolutions/mcp-obsidian

v1.1.0 — 102 Tools, Full Obsidian CLI Coverage

mcp-obsidian v1.1.0

102 tools — full Obsidian CLI coverage. Up from 63 in v1.0.1.

Install

Claude Desktop — download mcp-obsidian-1.1.0.mcpb below, double-click, enter your vault paths.

Claude Code:

claude mcp add -e OBSIDIAN_VAULTS='{"My Vault":"/path/to/vault"}' obsidian -- npx @wickedevolutions/mcp-obsidian

npm:

npm install -g @wickedevolutions/mcp-obsidian

New Tools (37)

• Metadata & Navigation: file info, folder info, list folders, aliases, recents, random note
• Bookmarks: add/list bookmarks
• File Creation & Rename: template-based creation, rename and move via Obsidian engine (updates link cache)
• Version Management: diff versions, restore, list files with history
• Properties: read single property value
• Search: search with line-level context
• Plugin Management: get info, list enabled, enable/disable
• Sync: status, history, read version (read-only)
• CSS Snippets: list, list enabled, enable/disable
• Themes: list, get active, set
• Bases: create item, list views
• Vault Info: vault metadata, list all known vaults
• Workspace: workspace tree
• Hotkeys: get hotkey, list all

Bug Fixes

• #4: search_replace_in_file no longer destroys files when search text not found
• #8: CLI error detection — commands that fail now properly return errors instead of false success
• list_known_vaults — fixed to call CLI without vault parameter

See CHANGELOG.md and README for full details.

v1.0.1 — First Public Release

mcp-obsidian v1.0.1

Multi-vault Obsidian MCP server — 63 tools across two tiers.

Install

Claude Desktop — download mcp-obsidian-1.0.0.mcpb below, double-click, enter your vault paths.

Claude Code:

claude mcp add -e OBSIDIAN_VAULTS='{"My Vault":"/path/to/vault"}' obsidian -- npx @wickedevolutions/mcp-obsidian

npm:

npm install -g @wickedevolutions/mcp-obsidian

Highlights

• 30 filesystem tools (always available) + 33 CLI tools (Obsidian 1.12+ with CLI enabled)
• Unified multi-vault — single server, all vaults via vault parameter
• File ops, wikilinks, semantic search, frontmatter queries, section editing, cross-vault search
• Daily notes, tasks, tags, properties, templates, bases, commands, history
• OBSIDIAN_DISABLED_TOOLS env var to filter tools at startup
• Works with Claude Code, Claude Desktop, Gemini CLI, Cursor, Windsurf, VS Code

See README for full setup and tool reference.