Obsidian Vault MCP
A local-first literature research workflow connecting Zotero, MinerU, Obsidian, and AI agents.
Version 3.0.1
Quick start Full installation GitHub Changelog
From papers to a knowledge base
Zotero Desktop → stable zoteroKey → Markdown main note + PDF
→ MinerU full text, images, formulas → 31 MCP Tools → 7 Agent Skills
→ 5 Analysis types → Obsidian Base and knowledge base
31
MCP Tools7
Agent Skills5
Analysis Types1
Analysis BaseWhat it does
Zotero and attachments
Import and synchronize parent items using a stable `zoteroKey`, with PDFs.MinerU
Parse full text, images, and formulas into paper-isolated relative paths.Analysis and Wiki
Five structured analysis types, Literature/Analysis Base, and traceable Wiki.Recoverable writes
dry-run, transactions, backups, conflict protection, atomic replacement, and rollback.Agent workflows
Codex, Claude Code, OpenCode, Pi, Hermes, and WorkBuddy integration.Quick install (after release)
uv tool install "zotero-obsidian-mcp==3.0.1"
obsidian-vault-mcp --help
obsidian-vault-mcp call literature_version --json '{}'
uvx --from "zotero-obsidian-mcp==3.0.1" obsidian-vault-mcp --help
Documentation
Full installation
Requirements, package managers, Vault, Zotero, MinerU, verification, privacy.Configuration
The only Vault configuration, Schema, and Skill customizations.Zotero import and sync
Parent items, attachments, and synchronization.MinerU parsing
Full text, images, formulas, and transactional output.Analysis and Skills
Five outputs, Analysis.base, and seven workflows.Agent clients
The clients and installation methods actually supported by installers.MCP Tools
31-tool reference generated from the runtime registry.Troubleshooting
doctor, verify, paths, and client issues.Development
Pages source, testing, and contribution.Real interface
