Skip to content

v2.1.0 — Zotero integration

Choose a tag to compare

@psypeal psypeal released this 12 Apr 07:48
· 17 commits to main since this release

New: Zotero integration

/knowledge-vault:ingest-zotero <collection> batch-ingests papers from a Zotero collection via the zotero-mcp server. Each Zotero item becomes one raw/<slug>.md with Zotero-specific frontmatter (zotero_key, citekey, doi, year, authors). Downstream /knowledge-vault:compile handles Zotero-sourced files identically to PubMed/Scholar-sourced ones.

Setup

```bash
uv tool install zotero-mcp-server && zotero-mcp setup
claude mcp add zotero -s project -e ZOTERO_LOCAL=true -- zotero-mcp serve
```

Then in any project with a .vault/:

```
/knowledge-vault:ingest-zotero
```

Abstract-only handling

Many Zotero collections contain reference-only items — metadata and abstract but no attached PDF. v2.1.0 explicitly handles this case by synthesizing structured Key Findings / Methods / Quantitative Data sections from the abstract itself, producing usable raw files even without fulltext. No stub placeholders.

Validation

  • Unit-tested against 4 synthetic fixtures (full metadata, minimal metadata, duplicate slug, YAML escaping) — all pass
  • End-to-end validated against a real 63-item Zotero collection (Air-Pollution-Dementia): 3-item batch ingest → manual compile → index rebuild, 100% clean

What's in this release

  • New command /knowledge-vault:ingest-zotero — batch ingest from Zotero collection
  • New script scripts/ingest-zotero.sh — Zotero-aware raw file creation with extended frontmatter
  • scripts/detect-mcp-sources.sh — detects zotero-mcp and adds it to the recommended list
  • commands/setup-sources.md — mentions zotero-mcp install
  • README: new Zotero Integration section, architecture diagram updated, commands table, credits

Credits