v3.0.2

Obsidian Vault MCP 3.0.2

• Fixed MinerU HTML table images so validated local figures are normalized and packaged.

• Five Analysis types with deterministic Obsidian Base views.

• 31 MCP tools across the production architecture.

• Transactional Vault writes with dry-run, backups, conflict protection, and rollback.

• Seven packaged Agent Skills for literature research workflows.

• Codex, Claude Code, OpenCode, Pi, Hermes, and WorkBuddy integration.

• Zotero, MinerU, and Obsidian workflow support.

• Dual CLI entry points: obsidian-vault-mcp and zotero-obsidian-mcp.

v3.0.1

Obsidian Vault MCP 3.0.1

• Five Analysis types with deterministic Obsidian Base views.
• 31 MCP tools across the production architecture.
• Transactional Vault writes with dry-run, backups, conflict protection, and rollback.
• Seven packaged Agent Skills for literature research workflows.
• Codex, Claude Code, OpenCode, Pi, Hermes, and WorkBuddy integration.
• Zotero, MinerU, and Obsidian workflow support.
• Dual CLI entry points: obsidian-vault-mcp and zotero-obsidian-mcp.

v3.0.0

Obsidian Vault MCP V3

• Five Analysis types with deterministic Base views.
• 31 MCP tools across the stable V2 surface and V3 Analysis.
• Transactional V2-to-V3 migrations with preview and rollback.
• Seven recursively packaged Agent Skills.
• Dual CLI entry points: obsidian-vault-mcp and zotero-obsidian-mcp.

Obsidian Vault MCP v2.1.0

Highlights

• Adds seven model-independent literature tools for precise paper reading, structured analysis, uncertainty review, index rebuilding, and scoped retrieval. The MCP surface now contains 33 tools.
• Improves MinerU normalization with traceable evidence spans, formal image assets, coverage checks, and verification of missing or ambiguous content.
• Ships the native obsidian-literature marketplace plugin for Codex Desktop/CLI and Claude Code, including nine literature Skills and a dedicated Codex App icon.
• Keeps platform-appropriate adapters for OpenCode, Pi, Hermes, and WorkBuddy.
• Adds deterministic wheel, sdist, and 15-file plugin bundle verification, cross-platform CI, credential/path scanning, and production installation tests.

Install

pipx install "zotero-obsidian-mcp==2.1.0"
# or
uv tool install "zotero-obsidian-mcp==2.1.0"

Install the native plugin after the Python tool is available on the client startup PATH:

obsidian-vault-mcp agent install codex
# or
obsidian-vault-mcp agent install claude

Codex and Claude users upgrading from the legacy project .mcp.json layout should use the native plugin commands above and restart the desktop/CLI client.

Validation

• Ruff: passed
• Python: 206 tests and 11 subtests passed
• Pi TypeScript extension: passed tsc --noEmit
• Plugin Creator and Claude strict validators: passed
• Wheel isolated install, MCP handshake, wheel/sdist/plugin bundle verification, and real Zotero → MinerU → Obsidian acceptance: passed

Full changelog: v2.0.1...v2.1.0

v2.0.1

What's Changed

• fix: support Zotero linked attachments by @luffysolution-svg in #8

Full Changelog: v2.0.0...v2.0.1

v2.0.0

What's Changed

• feat: release Obsidian Vault MCP V2 by @luffysolution-svg in #7

Full Changelog: v1.1.5...v2.0.0

v1.1.5 - Skill sync lint and AI summaries

Highlights

• Adds scripts/check_skills_sync.py to verify authoritative skills, packaged skills, agent descriptors, summary mirrors, and registered-tool references.
• Implements write_ai_summary=true for pipeline item import, MinerU parsing, and collection ingestion while preserving non-empty user summaries.
• Thins obsidian-views into a research-view skill that delegates Canvas/Bases/Markdown syntax to Kepano/Obsidian format skills and installs them into .claude/skills when missing.
• Adds small eval scenarios across all bundled skills.
• Bumps package/plugin version to 1.1.5 and refreshes release artifacts.

v1.1.4 — Canvas examples reference, recursive skill sync

Changes

obsidian-views — Canvas examples reference

• Added references/canvas-examples.md with complete worked examples from kepano/obsidian-skills (mind maps, project boards, research canvases, flowcharts)
• SKILL.md Canvas section now links to the examples file

Infrastructure

• CLAUDE.md sync rules updated to use cp -r (recursive) to handle references/ subdirectories
• Skill list in sync script extended to include obsidian-ai-summary

v1.1.3 — Canvas layout algorithms, obsidian-ai-summary skill, MinerU rename fix

Changes

New skill: obsidian-ai-summary

• Three trigger modes: explicit request, post-import prompt, pipeline flag write_ai_summary=true
• Source priority: MinerU full-text > literature note
• Standard 5-section template: Core Finding / Method / Dataset / Limitations / My Assessment
• Non-destructive write-back (preserves all other sections)

obsidian-views — Canvas upgrade

• Kepano json-canvas skill detection (reference-first with built-in fallback)
• Concrete layout formulas: Grid, Radial, Layered (DAG topological sort), Grouped
• Bounding-box overlap detection algorithm
• Color table, node size guidelines, ID generation rules
• Pure-JSON visual validation steps (no MCP required)

Cross-skill references

• obsidian-zotero, obsidian-mineru, obsidian-vault now point to obsidian-ai-summary skill

Bug fixes (MCP server)

• Path.rename() → Path.replace(): idempotent, overwrite-safe on Windows (no WinError 183)
• parse_with_mineru: wrap rename call in try/except so extraction status is always persisted

v1.1.2

What's Changed

Bug Fixes

• Fix unused importlib import in test suite (ruff F401 CI failure)

Skills — New Workflows

• obsidian-zotero: Reading a Single Paper (Q&A / evidence search), Comparing Multiple Papers (structured table), Writing a Literature Review (3-phase: collect → deep-read → synthesize)
• obsidian-mineru: Figure & Table Analysis — locate figures via images-index.md, answer from caption + context without decoding image bytes
• obsidian-graph: Knowledge Gap Detection (isolated nodes, sparse communities, bridge nodes) + Surprising Connections (cross-community edge ranking)

Skills — Package Fix

• obsidian-graph skill was missing from the PyPI wheel entirely — now included
• All 6 skills synced between skills/ (release zip) and scripts/obsidian_vault_mcp/skills/ (wheel)
• .claude/skills/obsidian-zotero.md mirror created (was missing)

Documentation

• AI install prompt updated: added Cursor, Windsurf, VS Code + Copilot setup steps; removed incorrect ~/.claude/skills/ copy instruction; MinerU check now shows concrete command
• Both README.md (Chinese) and README.en.md updated in sync
• Added CLAUDE.md with development guidelines: 3-directory skills sync rule, version sync rule, PyPI re-publish requirement