zotero-obsidian-bridge

Converts Zotero collections into canonical Obsidian paper notes, synthesis notes, and literature canvases.

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill zotero-obsidian-bridge-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zotero-obsidian-bridge
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/zotero-obsidian-bridge
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill zotero-obsidian-bridge-tamagusko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Researchers collect papers in Zotero but struggle to turn them into durable, project-linked reading notes and literature synthesis inside an Obsidian knowledge base, often losing coverage tracking and cross-paper structure. ## Core Features & Use Cases - Canonical paper notes: Creates or updates one detailed note per paper under Papers/ with a strict schema covering claim, method, evidence, limitations, and repo relevance. - Collection coverage audits: Tracks item-to-note mapping and coverage counts (e.g., 16/16) in a durable inventory note per Zotero collection. - Synthesis and visualization: Generates Knowledge/ synthesis notes and a semantically filtered Maps/literature.canvas argument map. - Use Case: Import an entire Zotero collection for a research project, produce one verified reading note per paper, update a literature overview, and refresh the canvas graph in a single pass. ## Quick Start Import all papers from my Zotero collection into the bound Obsidian vault, creating canonical paper notes and a coverage inventory.

Frequently Asked Questions about zotero-obsidian-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import a Zotero collection into Obsidian notes?

Read items from the target Zotero collection via MCP, then create or update one canonical note per paper under Papers/ using the defined schema. Finish by updating the collection inventory note and refreshing the literature canvas.

How do I check that every Zotero paper has a note?

Run the verify_paper_notes.py script with the papers directory, the expected comma-separated Zotero keys, and the inventory note path. It reports missing keys, duplicate keys, missing headings, and inventory mismatches.

What happens when Zotero MCP is not working?

The workflow falls back to a local zotero-mcp checkout or Python environment to read metadata and fulltext instead of aborting. It explicitly reports that MCP transport failed and what remained unavailable.

Does it create duplicate notes for existing papers?

No. The skill enforces one canonical note per paper and updates the existing note in place rather than creating siblings. The verification script also flags duplicate zotero_key values across notes.

Can Zotero webpage items be used as literature sources?

Yes. Webpage items are treated as valid literature entries when they still expose useful metadata, attachment text, or fulltext, and they follow the same canonical note schema as regular papers.