Zotero Library MCP

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

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

Company-knowledge compatible fetch for one Zotero item key.

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

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)

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 …

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)

Get full details of a Zotero item by its key. Args: item_key: The Zotero item key

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)

Get recently added items from your Zotero library. Args: limit: Maximum number of items to return (default 10)

Get items that are not in any collection (unfiled items). Args: limit: Maximum number of items to return (default 25)

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

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

List all collections in your Zotero library.

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.

List child notes for an item with bounded note content.

List all tags in your Zotero library. Args: limit: Maximum number of tags to return (default 100)

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

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

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

Remove one or more tags from a Zotero item. Args: item_key: The Zotero item key tags: List of tags to remove

Rename a Zotero collection without changing its parent.

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

Restore an item from Zotero's trash.

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.

Save a Zotero PDF to an authorized local server path.

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

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

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)

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)

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

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

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

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.

Replace the content of an existing Zotero note.

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)