Help us improve
Share bugs, ideas, or general feedback.
From Obsidian Vault
Imports and synchronizes Zotero literature with an Obsidian vault. Searches Zotero library, inspects items/collections, imports notes with attachments and annotations, and batch-ingests collections.
npx claudepluginhub luffysolution-svg/obsidian-vault-mcpHow this skill is triggered — by the user, by Claude, or both
Slash command
/obsidian-vault:obsidian-zoteroThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use the Zotero tools in this plugin when the request starts from the user's local Zotero library and the destination is an Obsidian vault.
Manages literature workflow bridging Zotero and Obsidian: creates paper notes, extracts evidence records, links synthesis to source notes, and maintains knowledge maps.
Adds abstracts, attaches PDFs, enriches metadata, deduplicates, and fixes BBT citation keys in a Zotero library. For standalone library housekeeping, not full systematic reviews.
Manage Zotero reference libraries via Python using the pyzotero client. Retrieve, create, update, delete items, collections, tags, and attachments through the Zotero Web API v3.
Share bugs, ideas, or general feedback.
Use the Zotero tools in this plugin when the request starts from the user's local Zotero library and the destination is an Obsidian vault. 处理 Zotero 到 Obsidian 的导入、同步、附件和批注时优先使用。
obsidian_zotero_ping before direct Zotero work.obsidian_zotero_search_items, obsidian_zotero_list_collections, obsidian_zotero_get_item, and obsidian_zotero_get_children to find the correct source record before importing.obsidian_pipeline_ingest_item for a single parent item.obsidian_pipeline_ingest_collection for collection batch import; it continues after per-item failures and returns a full report.zotero://select plus zotero://open-pdf links.write_ai_summary=true only when the user asks for a generated ## AI Summary; the tool fills empty summaries and leaves non-empty user summaries untouched.zoteroKey, zoteroVersion, zoteroSelect, zoteroPdfKeys, zoteroPdfLinks, original attachment paths, copied attachment paths, and Obsidian wikilinks.collections, not raw collection keys.## Reading Notes, and ## AI Summary.obsidian-ai-summary skill to generate or update that section — it can be triggered after import or via obsidian_pipeline_ingest_item(write_ai_summary=true).obsidian_zotero_list_pdf_attachments to inspect attachment inventory before import.obsidian_zotero_list_pdf_attachments to locate the attachment path, then extract text with a local PDF parser such as pypdf.obsidian-mineru skill when the request is about parsing a Zotero-linked PDF into full Markdown.Use when the user asks a question about a specific literature note or wants a summary, key findings, methods, or evidence from one paper.
obsidian_read_file.mineruStatus:
mineruStatus: parsed → read attachments/mineru/<zoteroKey>/paper.md via obsidian_read_file. This is the richest source (full structured text + figure captions).obsidian_search with a focused keyword before reading the full file — this often answers the question in ≤ 2 tool calls.## Reading Notes content as primary evidence when answering.Budget: ≤ 3 tool calls for a typical factual question. Escalate to full-file read only if search is insufficient.
Use when the user wants a structured comparison across 2–10 literature notes (methods, results, datasets, limitations, etc.).
obsidian_read_file. This covers most comparisons.obsidian_search with a targeted keyword. Scope the search by including the paper title or zoteroKey in the query to avoid cross-paper noise.| Paper | Method | Dataset | Key Result | Limitation |
|-------|--------|---------|------------|------------|
| Author YYYY | … | … | … | … |
Use when the user wants to draft or scaffold a review section covering multiple papers on a topic.
obsidian_search with the review topic as query; set extensions=".md".type: literature in frontmatter.mineruStatus: parsed → read MinerU Markdown (attachments/mineru/<zoteroKey>/paper.md).## Reading Notes content — it is primary evidence.[[Lovelace 2024 - Zotero Article]] to cite papers.obsidian_write_file to a path agreed with the user (e.g. reviews/Topic Review Draft.md).status: draft in frontmatter.obsidian_zotero_ping, then obsidian_pipeline_ingest_item(write_ai_summary=true). Must not overwrite existing ## Reading Notes or a non-empty ## AI Summary.mineruStatus: parsed, and answer from local evidence. Must not import, re-ingest, or write files.obsidian_search only for missing details, return a Markdown table plus short synthesis. Must preserve user notes as primary evidence.