Which integrations are available for this server?

Provides tools for reading, writing, searching files, and updating properties within an Obsidian vault, as well as managing literature notes and attachments as part of a Zotero-to-Obsidian pipeline. Integrates with Zotero Desktop's local API to search items, list collections, retrieve item metadata, children, and PDF attachments for importing into Obsidian.

How do I use Obsidian Vault MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Obsidian Vault MCP Ingest Zotero item ABC123 into vault." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Obsidian Vault MCP

by luffysolution-svg

Overview Schema Related Servers Score Discussions

Python

Local

Obsidian Vault MCP

面向科研文献工作流的本地 MCP 服务：以 Zotero 管理来源，以 MinerU 提取全文，以 Obsidian 沉淀文献、Wiki 与结构化 Analysis，并通过 Skills 让 AI Agent 按可追溯流程工作。

English · 完整安装教程 · 开发文档 · 更新日志 · 贡献者

架构

用户自然语言任务
        ↓
7 个科研 Skills：识别意图、规划步骤、约束证据与输出
        ↓
31 个 MCP Tools：版本契约、查询、导入、解析、检索、校验与事务写入
        ↓
Zotero Desktop ── PDF ── MinerU ── Obsidian Vault
                                      ├─ Literature 主笔记
                                      ├─ PDF 与全文 Markdown
                                      ├─ Index / Literature.base
                                      ├─ Wiki
                                      └─ 五类 Analysis / Analysis.base

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

Related MCP server: zoty

核心功能

稳定文献身份：以 Zotero 父条目 zoteroKey 作为主键。
Zotero 导入与同步：支持单篇、Collection、notes、annotations、BibTeX、存储附件和链接附件。
MinerU 全文解析：将 PDF 规范化为 Markdown，每篇文献使用独立图片目录和相对链接。
Obsidian 文献库：自动维护 Literature/index.md、Literature/Literature.base、主笔记、PDF、全文和 Wiki。
结构化研究层：支持 full_read、literature_review、passage_qa、figure_qa、concept 五类 Analysis。
统一数据库视图：Literature/Analysis/Analysis.base 提供 9 个视图。
科研 Skills：内置 paper-qa、full-read、passage-qa、figure-qa、compare-papers、literature-review、concept-learning。
安全写入：支持 dry-run、staging、锁、备份、原子替换、事务预览和回滚。
版本可验证：literature_version 返回当前版本、31 个工具、7 个 Skills 和五类 Analysis。
多客户端接入：支持 Codex、Claude Code、OpenCode、Pi、Hermes 和 WorkBuddy。

效果展示

文献目录

Literature Index

多篇文献形成的可追溯 Wiki

安装

3.0.1 已正式发布，要求 Python 3.10+。以下公开安装命令现已可用。

uv（推荐）

uv tool install "zotero-obsidian-mcp==3.0.1"
obsidian-vault-mcp --help

无需持久安装：

uvx --from "zotero-obsidian-mcp==3.0.1" obsidian-vault-mcp doctor --vault-path "<VAULT_PATH>"

pipx / pip

pipx install "zotero-obsidian-mcp==3.0.1"
# 或
python -m pip install "zotero-obsidian-mcp==3.0.1"

MCP Registry

io.github.luffysolution-svg/obsidian-vault-mcp

等价的 stdio 配置：

{
  "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>"
      }
    }
  }
}

首次配置

目标目录必须是已由 Obsidian 打开过的 Vault，并包含 .obsidian/。

obsidian-vault-mcp config init --vault-path "<VAULT_PATH>" --dry-run
obsidian-vault-mcp config init --vault-path "<VAULT_PATH>"
obsidian-vault-mcp config validate --vault-path "<VAULT_PATH>"
obsidian-vault-mcp doctor --vault-path "<VAULT_PATH>"
obsidian-vault-mcp call literature_version --json '{}'

启动 Zotero Desktop 并启用本地 API：

obsidian-vault-mcp call zotero_search_items --json '{"query":"photocatalysis"}'
obsidian-vault-mcp import item ABCD1234 --vault-path "<VAULT_PATH>" --dry-run
obsidian-vault-mcp import item ABCD1234 --vault-path "<VAULT_PATH>"

链接附件配置：

{
  "zotero": {
    "linkedAttachmentBaseDir": "<ZOTERO_LINKED_ATTACHMENT_BASE_DIR>"
  }
}

MinerU 解析：

obsidian-vault-mcp mineru parse ABCD1234 --vault-path "<VAULT_PATH>" --dry-run
obsidian-vault-mcp mineru parse ABCD1234 --vault-path "<VAULT_PATH>"

规范产物：

Literature/attachment/MinerU/ABCD1234.md
Literature/attachment/MinerU/image/ABCD1234/ABCD1234-fig01.png

Agent 与插件安装

obsidian-vault-mcp agent install codex --dry-run
obsidian-vault-mcp agent install codex

客户端名称可替换为 claude、opencode、pi、hermes 或 workbuddy。

客户端	安装内容
Codex	原生 marketplace 插件、MCP 和 7 Skills
Claude Code	原生 marketplace 插件、MCP 和 7 Skills
OpenCode	项目本地 MCP 和 7 Skills
Pi	薄 TypeScript Extension
Hermes	MCP 配置
WorkBuddy	MCP 配置

GitHub Release 中的离线插件包：

obsidian-vault-mcp-3.0.1-plugins.zip

Skills

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

正式工具面

分组	数量
版本、系统与配置	5
Zotero	6
导入与同步	4
MinerU	3
导航与校验	3
Analysis	5
Wiki	3
事务	2
合计	31

发布一致性

3.0.1 必须同时出现在 Python 包、运行时 __version__、MCP Registry server.json、Codex/Claude 插件清单、Pi 包、Git Tag v3.0.1、GitHub Release 和 PyPI 中。Release workflow 会校验版本、Tag 和产物身份，构建 wheel、sdist、插件 ZIP，执行测试与 handshake，并生成 SHA256SUMS。

安全边界

所有写操作先 dry-run，再提交并保存 transactionId。
不要提交 Vault 绝对路径、Zotero 数据目录、MinerU token 或其他凭据。
MinerU 可能把 PDF 发送到外部服务，使用前确认授权和组织政策。
推荐本地 stdio；SSE/HTTP 必须放在可信认证边界之后。
事务备份不替代独立的 Vault 备份。

贡献者

感谢方珸 / Lym Fang (@LimFang) 提出 Zotero 链接附件兼容方案。完整记录见 CONTRIBUTORS.md。

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

6hResponse time

2dRelease cycle

37Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

MCP Tools for Obsidian
Note Taking Autonomous Agents Developer Tools
jacksteamdev
A
license
-
quality
F
maintenance
A local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.
Last updated 2026-05-13
834
MIT
zoty
Research & Data Note Taking Developer Tools
eric-tramel
A
license
A
quality
C
maintenance
A lightweight MCP server that connects AI agents to a local Zotero library for paper management and metadata retrieval. It enables users to search titles and abstracts, browse collections, and automatically ingest papers via arXiv ID or DOI with PDF attachments.
Last updated 2026-05-16
8
15
MIT
brain-mcp
Note Taking Knowledge & Memory File Systems
delian-research
A
license
A
quality
D
maintenance
An MCP server for managing Obsidian-style note vaults, providing tools for full-text search, note creation, and backlink tracking. It enables users to navigate, structure, and update their personal knowledge base through natural language.
Last updated 2026-03-13
9
MIT
obsidian-local-mcp
Note Taking File Systems Developer Tools
MatthewSuazo
F
license
-
quality
D
maintenance
A local MCP server that wraps the Obsidian CLI to give AI assistants direct access to read, edit, and manage notes within an Obsidian vault. It enables advanced operations such as frontmatter property management, context-aware searching, and the execution of internal Obsidian commands.
Last updated 2026-03-24
2

View all related MCP servers

Related MCP Connectors

zoteus
The everything Zotero MCP server — Web API v3 + local API, safe writes, citations, search.
better-notion-mcp
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
Remote Desktop Commander
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/luffysolution-svg/obsidian-vault-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Obsidian Vault MCP

架构

核心功能

效果展示

文献目录

Literature Index

多篇文献形成的可追溯 Wiki

安装

uv（推荐）

pipx / pip

MCP Registry

首次配置

Agent 与插件安装

Skills

正式工具面

发布一致性

安全边界

贡献者

Maintenance

Resources

Looking for Admin?

Related MCP Servers

MCP Tools for Obsidian

zoty

brain-mcp

obsidian-local-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API