Obsidian Vault MCP Server

Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes.

Local serverstdioPython

What is the Obsidian Vault MCP MCP server?

Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes. That is what the obsidian vault mcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

项目不绑定大模型供应商。MCP Tools 负责确定性的本地数据操作,Skills 负责把工具编排成可复用的科研工作流。

The tools it exposes

The server publishes 14 tools. What each one is for:

  • Codex — 原生 marketplace 插件、MCP 和 7 Skills
  • OpenCode — 项目本地 MCP 和 7 Skills
  • Hermes — MCP 配置
  • WorkBuddy — MCP 配置
  • Skill — 工作流
  • paper-qa — 单篇快速问答,默认不写入 Vault
  • full-read — 单篇完整精读并保存 full_read
  • passage-qa — 定位具体段落、方法、数据或结论
  • figure-qa — 解读图、表、Scheme 和方程
  • compare-papers — 对用户选定论文建立可比性矩阵
  • literature-review — 对文献池进行主题化综述
  • concept-learning — 跨文献建立概念模型

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

What it needs from you

Configuration is passed through the environment: OBSIDIAN_VAULT_PATH, VAULT_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Obsidian Vault MCP's toolset — Codex, OpenCode, Hermes and 11 more — is a fair guide to whether it matches your workflow. It is maintained by luffysolution-svg; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Obsidian Vault MCP.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
Codex原生 marketplace 插件、MCP 和 7 Skills
OpenCode项目本地 MCP 和 7 Skills
HermesMCP 配置
WorkBuddyMCP 配置
Skill工作流
paper-qa单篇快速问答,默认不写入 Vault
full-read单篇完整精读并保存 full_read
passage-qa定位具体段落、方法、数据或结论
figure-qa解读图、表、Scheme 和方程
compare-papers对用户选定论文建立可比性矩阵
literature-review对文献池进行主题化综述
concept-learning跨文献建立概念模型
Zotero6
MinerU3

How to install the Obsidian Vault MCP MCP server

{
  "mcpServers": {
    "obsidian-literature": {
      "command": "uvx",
      "args": [
        "--from",
        "zotero-obsidian-mcp==3.0.1",
        "obsidian-vault-mcp",
        "serve",
        "--transport",
        "stdio"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<VAULT_PATH>"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
OBSIDIAN_VAULT_PATHFilesystem location the server is allowed to use.Optional
VAULT_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Obsidian Vault MCP to Codex.
  • Use Obsidian Vault MCP to OpenCode.
  • Use Obsidian Vault MCP to Hermes.

Frequently asked questions

It connects Obsidian Vault MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (Codex, OpenCode, Hermes, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Obsidian Vault MCP directly.