Obsidian Vault MCP

面向科研文献工作流的本地 MCP 服务:以 Zotero 管理来源,以 MinerU 提取全文,以 Obsidian 沉淀文献、Wiki 与结构化 Analysis,并通过 Skills 让 AI Agent 按可追溯流程工作。. It runs locally over stdio via the published package.

People connecting productivity tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-11 · ★ 76 · #26 OF 139 MAINTAINED PRODUCTIVITY · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Obsidian Vault MCP

before you install - you'll need

Set OBSIDIAN_VAULT_PATH before connecting.

Claude Code

claude mcp add luffysolution-svg-obsidian-vault-mcp -- uvx zotero-obsidian-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "luffysolution-svg-obsidian-vault-mcp": {
      "command": "uvx",
      "args": [
        "zotero-obsidian-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package zotero-obsidian-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.luffysolution-svg is GitHub-verified and matches the repo owner

03 · What Obsidian Vault MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v3.0.2 · 2026-08-11

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…

v3.0.1 · 2026-07-30

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…

v3.0.0 · 2026-07-30

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…

04 · Who maintains Obsidian Vault MCP

Obsidian Vault MCP is maintained by luffysolution-svg. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

category
productivity - ranked #26 of 139 actively-maintained productivity servers as of 2026-08-25.
release cadence
10+ releases in the last 90 days (latest 2026-08-11)
registry
io.github.luffysolution-svg/obsidian-vault-mcp (active, first published 2026-07-30 · 3 versions)
packages
pypi:zotero-obsidian-mcp

06 · Obsidian Vault MCP FAQ

What is Obsidian Vault MCP?

面向科研文献工作流的本地 MCP 服务:以 Zotero 管理来源,以 MinerU 提取全文,以 Obsidian 沉淀文献、Wiki 与结构化 Analysis,并通过 Skills 让 AI Agent 按可追溯流程工作。. It runs locally over stdio via the published package.

Is Obsidian Vault MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-11 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

How do I install Obsidian Vault MCP?

Run `uvx zotero-obsidian-mcp`. The README documents one environment variable (OBSIDIAN_VAULT_PATH) to set first. Set OBSIDIAN_VAULT_PATH before connecting. You can also paste the ready-made client config above.

Does Obsidian Vault MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Obsidian Vault MCP