How do I install the obsidian vault mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `OBSIDIAN_VAULT_PATH`, `VAULT_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Obsidian Vault MCP Server

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

Local serverstdioPython

What is the Obsidian Vault MCP Server?

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

The short version

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
paper-qa	单篇快速问答，默认不写入 Vault
full-read	单篇完整精读并保存 full_read
passage-qa	定位具体段落、方法、数据或结论
figure-qa	解读图、表、Scheme 和方程
compare-papers	对用户选定论文建立可比性矩阵
literature-review	对文献池进行主题化综述
concept-learning	跨文献建立概念模型

How to install the Obsidian Vault 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

Variable	Description	Required
OBSIDIAN_VAULT_PATH	Filesystem location the server is allowed to use.	Optional
VAULT_PATH	Filesystem 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

Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.