List the key owner's personal library and a page of shared group libraries.

Use the returned library_id and library_type on subsequent tool calls. This does not change the default library. Pagination applies to groups; the personal library is included on each page. Key permissions are not a guarantee of group membership rights; Zotero enforces access on each call.

Add a paper to your Zotero library by its DOI.

Resolves metadata automatically via CrossRef and creates the item in Zotero. Optionally add it to a specific collection.

Args: doi: The DOI of the paper (e.g. "10.1038/nature12373") collection_id: Optional Zotero collection key to add the paper to

Add multiple papers to Zotero by their DOIs (batch, up to 50).

Args: dois: List of DOIs to add collection_id: Optional Zotero collection key to add all papers to

Add a paper to your Zotero library by its arXiv ID.

Fetches metadata from the arXiv API. If the paper has a DOI, resolves it via CrossRef for richer metadata; otherwise creates a preprint entry directly. Optionally add it to a specific collection.

Args: arxiv_id: The arXiv ID of the paper (e.g. "2301.07041") collection_id: Optional Zotero collection key to add the paper to

Add a book to your Zotero library by its ISBN.

Resolves metadata automatically via Open Library and creates the item in Zotero. Optionally add it to a specific collection.

Args: isbn: The ISBN of the book (e.g. "9780262046824") collection_id: Optional Zotero collection key to add the book to

Add an item from manual, CSL-like, or previously parsed metadata.

The Zotero item template determines which fields are accepted for the requested item type, preventing invalid cross-type metadata.

Get items that are not in any collection (unfiled items).

Args: limit: Maximum number of items to return (default 25)

Search your Zotero library. Falls back to fuzzy matching if the exact search returns no results.

Args: query: Search query matched against titles, creators, and year (use search_fulltext for abstracts, notes, and PDF text) limit: Maximum number of results per page (default 10, max 100) start: Offset of the first result; pass the value suggested by the previous call's footer to fetch the next page (default 0)

Get full details of a Zotero item by its key.

Args: item_key: The Zotero item key

Export BibTeX entries from your Zotero library.

Can export specific items, an entire collection, or your whole library. Use save_bibtex when the export should be written to a local file.

Args: item_keys: Optional list of item keys to export. If omitted, exports collection or full library. collection_id: Optional collection key to export all items from. include_abstract: Include abstracts in BibTeX output (default False to save tokens). biblatex: Convert output to BibLaTeX format (default False). Remaps fields like journal→journaltitle, address→location, and merges year+month into date. max_chars: Maximum response size; use save_bibtex for larger full-library exports

Export BibTeX or BibLaTeX and atomically write it to a local file.

Path writes are available by default over local stdio. HTTP deployments must explicitly allow a confined file root.

Get bounded plain text from a paper's PDF or Zotero full-text index.

Unlike download_pdf, this returns readable text directly and never exposes a server-local temporary path.

Args: item_key: The Zotero item key (the parent item, not the attachment) attachment_key: Optional PDF attachment key when an item has several PDFs max_chars: Maximum number of characters to return (1,000-200,000)

Permanently delete an item from your Zotero library.

Args: item_key: The Zotero item key to delete

Get recently added items from your Zotero library.

Args: limit: Maximum number of items to return (default 10)

Verify that recently added items have valid DOIs that match CrossRef metadata.

Re-resolves each item's DOI via CrossRef and compares the title. Reports items that have no DOI, DOIs that don't resolve, or title mismatches.

Args: limit: Number of recent items to check (default 10)

Check Zotero credentials, library access, and optional file storage setup.

List attachment keys, filenames, MIME types, links, and sizes for an item.

Update selected bibliographic fields and optionally replace creators.

Immutable/internal fields such as item type, key, version, parent item, collections, tags, and deletion state cannot be changed through this tool.

Move an item to Zotero's trash so it can be restored later.

List items in Zotero's trash, e.g. to find a key for restore_item.

Args: limit: Maximum number of items per page (default 25, max 100) start: Offset of the first item; use the footer's suggestion for the next page

Restore an item from Zotero's trash.

Find duplicate top-level items by DOI, ISBN, or normalized title.

Search Zotero metadata and indexed full text using qmode=everything.

Company-knowledge compatible search over Zotero items and full text.

Company-knowledge compatible fetch for one Zotero item key.

List all collections in your Zotero library.

Add an existing Zotero item to a collection.

Args: item_key: The Zotero item key (from search results) collection_id: The collection key to add it to

Remove an item from a collection without deleting it from the library.

Args: item_key: The Zotero item key collection_id: The collection key to remove it from

Create a new collection in your Zotero library.

Args: name: Name for the new collection parent_collection_id: Optional parent collection key to nest under

Permanently delete a collection from your Zotero library.

Items in the collection are NOT deleted — they remain in your library.

Args: collection_id: The collection key to delete

Get items in a specific collection, one page at a time.

Args: collection_id: The collection key to browse limit: Maximum number of items to return per page (default 25, max 100) start: Offset of the first item; pass the value suggested by the previous call's footer to fetch the next page (default 0)

Rename a Zotero collection without changing its parent.

Move a collection under another collection, or to the library root.

List all tags in your Zotero library.

Args: limit: Maximum number of tags to return (default 100)

Delete tags from the entire Zotero library. This removes the tags from all items.

Args: tags: List of tag names to delete from the library

Add one or more tags to a Zotero item. Optionally assign a color to all added tags.

Args: item_key: The Zotero item key tags: List of tags to add color: Optional hex color code (e.g. '#FF0000') to assign to the added tags

Remove one or more tags from a Zotero item.

Args: item_key: The Zotero item key tags: List of tags to remove

Assign a color to a tag in the Zotero library. Colored tags appear in the tag selector and item lists.

Args: tag: The tag name to colorize color: Hex color code (e.g. '#FF0000' for red, '#3366CC' for blue) position: Sort position for the colored tag (0-8, lower = higher priority)

Rename a tag across all items in the Zotero library.

Args: old_name: The current tag name new_name: The new tag name to replace it with

Remove a tag's assigned library color without deleting the tag.

Add a note to a Zotero item.

The note is created as a child of the specified item. Supports HTML formatting (e.g. bold, italic, lists).

Args: item_key: The parent Zotero item key to attach the note to note: The note content (plain text or HTML)

Highlight a text passage in a PDF attached to a Zotero item.

Searches the PDF for the quoted text and creates a visible highlight annotation in Zotero's PDF reader. Tries a normalized word match first, then fuzzy matching (for OCR errors, hyphenation differences, or minor transcription mismatches).

Smart overlap handling:

• If the same text is already highlighted, appends the new comment to the existing annotation instead of creating a duplicate.

• If the new text is a sub-passage of an existing highlight (or vice versa), the new highlight is created in a contrasting color so both are visually distinct.

Args: item_key: The Zotero item key (the parent item, not the attachment) quoted_text: The text passage to highlight in the PDF (fuzzy matching handles minor differences from the actual PDF text) comment: Optional comment to attach to the highlight color: Highlight color as hex (default "#ffd400" yellow) max_l_dist: Maximum Levenshtein distance for fuzzy matching. Default is ~20% of the search text length. Increase if the PDF has many OCR errors; decrease for stricter matching. attachment_key: Optional PDF attachment key when the item has multiple PDFs page_number: Optional one-based page number to search occurrence: One-based occurrence to highlight when text repeats

List all highlights and annotations on a paper's PDF.

Args: item_key: The Zotero item key (the parent item, not the attachment) limit: Maximum number of annotations to return (default 100)

Attach a ChatGPT file input or an authorized local file to an item.

Args: item_key: The Zotero item key to attach the file to file: File object supplied by ChatGPT through openai/fileParams file_path: Local server path; stdio only unless HTTP roots are explicitly enabled

Return a PDF as a remote-safe MCP resource link.

Useful when Zotero's fulltext index is incomplete (e.g. for books) and you need to read the PDF directly with other tools.

Args: item_key: The Zotero item key (the parent item, not the attachment) attachment_key: Optional PDF attachment key when the item has multiple PDFs

Save a Zotero PDF to an authorized local server path.

List child notes for an item with bounded note content.

Replace the content of an existing Zotero note.

Permanently delete a Zotero note.

Update the comment and/or highlight color of an annotation.

Permanently delete a Zotero annotation.