Skip to content

Releases

v0.10.2

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 16 Oct 14:17
4e1c089
  • Install as a Claude Code plugin: /plugin install zotero --marketplace RaulSimpetru/zotero-library-mcp.
  • An empty ZOTERO_LIBRARY_TYPE now means the default (user), as plugin
    installs pass unset optional settings as empty strings.

Claude Code: /plugin install zotero --marketplace RaulSimpetru/zotero-library-mcp. Other clients: uvx zotero-library-mcp or pip install zotero-library-mcp==0.10.2.

v0.10.1

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 16 Oct 12:59
c94ae60
  • Attaching files to Zotero storage works again (group libraries and setups
    without WebDAV): Zotero rejects the full local path Pyzotero sent as the
    filename. Uploads are now confirmed, and a rate-limited or failed upload is
    reported instead of leaving an empty attachment.
  • list_tags returns every tag; Zotero's tag paging metadata is wrong past
    200 tags, which made the old listing drop the rest.
  • Leftover query parameters no longer leak between calls (e.g. a duplicate
    check after fetching an item template only searched items of that type).
  • Searches and tag renames containing the word "tags" no longer crash.
  • Tagging, filing, and editing notes or annotations works on trashed items.
  • Highlights land correctly on rotated pages with offset crop boxes, match
    whole words, check for duplicates at the same location only, and report a
    missing occurrence instead of highlighting a different passage.
  • arXiv imports detect existing copies of any version of the paper.
  • CrossRef imports keep organization authors and editors and map books,
    edited books, chapters, and dissertations to the right item types; Open
    Library books get their authors from the work record.
  • verify_items handles DataCite DOIs (arXiv, Zenodo), HTML in CrossRef titles,
    and subtitles; health_check reports read-only keys as write_access: false.
  • BibTeX exports keep Zotero's order and unique citekeys across pages.
  • Lists of child items (attachments, notes, annotations) are no longer capped at
    100; linked PDFs are skipped, and standalone PDFs can be read.
  • Removing the last tag color works; deleting tags containing || is refused.
  • Hardening for hosted HTTP deployments: downloads connect to the validated IP
    (DNS rebinding), JWKS refetches are rate-limited, and file saves use
    exclusive temporary files.
  • DOI imports no longer create duplicates. Zotero's search does not index
    DOIs, so the old check never matched; imports now search the resolved title
    and compare DOIs (including DOI: lines in Extra).
  • ISBN imports no longer create duplicates of books stored with hyphenated
    ISBNs; ISBN-10 and ISBN-13 forms now match each other.
  • search_library returns papers instead of matching attachments and notes.
  • Rate-limited writes are never retried (a retry could duplicate the item) and
    now fail instead of reporting success.
  • add_papers_by_dois(attach_pdfs=True) downloads PDFs in parallel.
  • search_fulltext and search query top-level items (about 20x faster).
  • Fuzzy search and find_duplicates reuse a library cache that is kept current
    with Zotero's incremental sync (since=), so repeat calls take well under a second.
  • CrossRef requests use UNPAYWALL_EMAIL as the polite-pool contact when
    CROSSREF_MAILTO is unset, and retry rate-limited requests.
  • create_annotation highlights quotes that wrap across lines in full, counts
    occurrence across pages, and uses the PDF's own page labels.
  • PDFs attached during DOI/arXiv import are named after the item title, and the
    result now says why a PDF was not attached.
  • List output shows the correct year for dates like 12/1/1993.
  • health_check returns library_type as user/group and reports whether
    open-access PDF lookup (UNPAYWALL_EMAIL) is configured.
  • New list_trash tool for finding keys to pass to restore_item.
  • Faster get_bibtex for item keys, rename_tag, get_recent_items, fuzzy
    searches, and find_duplicates; Zotero API connections are reused across calls.
  • Full-library and collection get_bibtex exports stop downloading once
    max_chars is exceeded.
  • get_item_fulltext prefers a PDF's index over a web snapshot's.
  • find_duplicates reports items_scanned and scan_capped.
  • search falls back to the item's zotero.org link when it has no URL.
  • Shorter tool descriptions; library targeting is explained once in the server
    instructions.

Install: uvx zotero-library-mcp or pip install zotero-library-mcp==0.10.1. Restart the MCP connection after upgrading.

v0.10.0 — Shared Zotero libraries

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 07 Sep 08:13
7d01c50

Personal and shared Zotero libraries can now be used through the same MCP connection.

  • New list_libraries tool discovers the key owner's personal library and shared groups, including IDs and key permissions.
  • All existing tools accept library_id and library_type for selecting a library per call. Omitting both preserves the configured default.
  • Concurrent requests and nested search, fetch, and export operations keep their selected library.
  • Group attachments use Zotero storage; personal WebDAV remains scoped to the configured personal library.
  • Current PyMuPDF imports and HTTP client logging preserve valid MCP stdio output and avoid logging credential-bearing URLs.

API key permissions and group membership still determine access. Restart the MCP connection after upgrading to load the new tools and schemas.

Validation: 79 tests passed; wheel and source distribution built; live stdio checks verified shared-library discovery and search, preservation of the personal default, and clean protocol output and logs.

Merged in #3.

v0.9.0

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 09 Aug 11:42
717cae2

Migrates the server to the MCP 2.0 Python SDK. Follow-up to the 0.8.3 hotfix, which pinned the SDK to <2 to stop fresh installs from breaking.

Requires mcp[cli]>=2.0.0. Stay on 0.8.3 if you need the 1.x SDK.

Changes

  • FastMCP → MCPServer; Context now imported from mcp.server.mcpserver.
  • Transport options (host, port, HTTP path, stateless mode, DNS-rebinding protection) moved from server-level settings to run() arguments in 2.0. configure_server() now returns them as a dict rather than mutating mcp.settings — same CLI flags and environment variables, no user-facing change.
  • Protocol type fields are read back as snake_case (isError → is_error, inputSchema → input_schema, and friends). Constructors still accept the camelCase aliases, but the codebase now uses one convention throughout.

Tool and resource definitions were untouched — the tool() and resource() decorators are identical between the two SDK versions.

Verification

60 tests pass on mcp 2.0.0. Both stdio and Streamable HTTP transports start and serve. A live run against a real Zotero library registers all 49 tools with working search, pagination, error handling, and PDF/image resource templates.

v0.8.3

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 09 Aug 11:34
e81c05a

Hotfix: pin the MCP Python SDK to <2.

The SDK's 2.0.0 release removed mcp.server.fastmcp (replaced by mcp.server.mcpserver). Because the dependency was declared as an unbounded mcp[cli]>=1.26.0, fresh installs resolved to 2.0.0 and the server crashed on import:

ModuleNotFoundError: No module named 'mcp.server.fastmcp'

MCP clients surfaced this as Connection closed / "failed to connect". Pinning to the 1.x line restores startup. A port to the 2.0 SDK API will follow in a later release.

v0.8.2

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 21 Jul 16:13

Pagination for large libraries (fixes #2):

  • get_collection_items and search_library accept a new start offset parameter
  • Both tools report totals in a footer, e.g. Showing items 101–200 of 566. Pass start=200 to get the next page.
  • search_library result cap raised from 50 to 100

Full Changelog: v0.8.1...v0.8.2

v0.8.1

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 21 Jul 16:13

Full Changelog: v0.8.0...v0.8.1

v0.8.0

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 21 Jul 16:13
fe40dec

What's Changed

New Contributors

Full Changelog: v0.7.4...v0.8.0

v0.7.4

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 21 Jul 16:13

Full Changelog: v0.7.3...v0.7.4

v0.7.3

Choose a tag to compare

@RaulSimpetru RaulSimpetru released this 21 Jul 16:13

Full Changelog: v0.7.2...v0.7.3