Zotero Library MCP server
io.github.RaulSimpetru/zotero-library-mcp·v0.5.0·2 starsAdd papers and books to Zotero by DOI, arXiv ID, or ISBN and manage your library
2 stars96 downloads/wk
Reviews
Write oneNobody has reviewed Zotero Library yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Zotero Library tools (29, 7 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_book_by_isbnAdd a book to your Zotero library by its ISBN.
add_noteAdd a note to a Zotero item.
add_paper_by_arxiv_idAdd a paper to your Zotero library by its arXiv ID.
add_paper_by_doiAdd a paper to your Zotero library by its DOI.
add_papers_by_doisAdd multiple papers to Zotero by their DOIs (batch, up to 50).
add_tagsAdd one or more tags to a Zotero item. Optionally assign a color to all added tags.
add_to_collectionAdd an existing Zotero item to a collection.
attach_fileAttach a local file (e.g. PDF) to an existing Zotero item.
create_annotationwrite actionHighlight a text passage in a PDF attached to a Zotero item.
create_collectionwrite actionCreate a new collection in your Zotero library.
delete_collectionwrite actionPermanently delete a collection from your Zotero library.
delete_itemwrite actionPermanently delete an item from your Zotero library.
delete_tagswrite actionDelete tags from the entire Zotero library. This removes the tags from all items.
download_pdfDownload the PDF attachment of a Zotero item to a local file.
get_annotationsList all highlights and annotations on a paper's PDF.
get_bibtexExport BibTeX entries from your Zotero library.
get_collection_itemsGet all items in a specific collection.
get_item_detailsGet full details of a Zotero item by its key.
get_item_fulltextGet the full text content of a paper (e.g. from an indexed PDF attachment).
get_recent_itemsGet recently added items from your Zotero library.
get_unfiled_itemsGet items that are not in any collection (unfiled items).
list_collectionsList all collections in your Zotero library.
list_tagsList all tags in your Zotero library.
remove_from_collectionwrite actionRemove an item from a collection without deleting it from the library.
remove_tagswrite actionRemove one or more tags from a Zotero item.
rename_tagRename a tag across all items in the Zotero library.
search_librarySearch your Zotero library.
set_tag_colorAssign a color to a tag in the Zotero library. Colored tags appear in the tag selector and item lists.
verify_itemsVerify that recently added items have valid DOIs that match CrossRef metadata.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan10 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 21 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Zotero Library compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,255 servers
- Tools
- 29
- the typical server has 7
- Tools that change things
- 24%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 75% of 28,688 servers
- Downloads a week
- 96
- more than 62% of 12,191 servers with a package
What its tools let an agent do: 13 read · 9 create · 2 change · 5 delete
Install Zotero Library in Claude Code, Cursor or VS Code
claude mcp add zotero-library-mcp -- uvx zotero-library-mcp
What the publisher says
From the Zotero Library repository's README, as published. We do not edit it. Read it on GitHub
zotero-library-mcp
An MCP server that lets Claude, Codex, and ChatGPT add papers and books to your Zotero library by DOI, arXiv ID, or ISBN — and manage your collections, tags, and items.
The server supports both MCP transports used by these clients:
- stdio (default) for Claude Code, Claude Desktop, Codex CLI/IDE, and the ChatGPT desktop app
- Streamable HTTP for a hosted ChatGPT app or any remote MCP client
Tools
Adding papers
- addpaperbydoi** — Resolve a DOI via CrossRef and add the paper to Zotero (with duplicate detection)
- addpapersbydois** — Batch-add up to 50 papers at once
- addpaperbyarxivid — Add a preprint by arXiv ID (uses DOI when available, falls back to arXiv metadata)
- additemfrommetadata** — Create any supported Zotero item type from validated manual metadata
Adding books
- addbookbyisbn** — Resolve an ISBN via Open Library and add the book to Zotero (with duplicate detection)
Searching & browsing
- list_libraries — Discover the API key owner's personal library and shared group libraries, with IDs and key permissions
- searchlibrary** — Search your Zotero library by title, author, tag, etc., paginated via start/limit (falls back to fuzzy matching when the exact search returns no results)
- getitemdetails — View full metadata for any item
- getrecentitems — List recently added items
- getunfileditems — Get items not in any collection
- searchfulltext** — Search Zotero metadata and indexed full text
- findduplicates** — Find duplicate items by DOI, ISBN, or normalized title
- listattachments** — List every attachment and choose a specific PDF key
- healthcheck** — Verify library credentials, access, and storage configuration
Reading & annotating
- getitemfulltext — Return bounded plain text from Zotero's index or a PDF, without leaking temporary paths
- getbibtex** — Read-only BibTeX/BibLaTeX export for items, a collection, or the full library
- savebibtex** — Save an export to an authorized local path
- getannotations** — List all highlights and annotations on a paper's PDF
- createannotation** — Highlight a text passage in a PDF (searches for the exact text, creates a visible highlight in Zotero's reader, and returns a preview image for verification). Smart overlap handling: exact duplicates update the existing comment; sub-passages get a contrasting highlight color automatically.
- addnote** — Add a note to an item
- listnotes, updatenote, deletenote** — Manage existing notes
- updateannotation, deleteannotation — Edit or remove annotations
File attachments
- attachfile** — Attach a local file over stdio or a ChatGPT file input over HTTP
- downloadpdf** — Return a remote-safe MCP file resource
- savepdf** — Save a PDF to an authorized local path
Collections
- listcollections** — List all collections (with nesting)
- createcollection** — Create a new collection (optionally nested under a parent)
- getcollectionitems — Browse items in a collection, paginated via start/limit
- addtocollection — Add an existing item to a collection
- removefromcollection — Remove an item from a collection (keeps it in your library)
- renamecollection, movecollection — Reorganize collections
Tags
- listtags** — List all tags in your library
- addtags** — Add one or more tags to an item (with optional color)
- removetags** — Remove tags from an item
- deletetags** — Delete tags from the entire library
- settagcolor — Assign a color to a tag (appears in Zotero's tag selector)
- renametag** — Rename a tag across all items in your library
- unsettagcolor — Remove a tag color without deleting the tag
Verification
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Zotero Library: common questions
- Is Zotero Library MCP server safe?
- Mostly: it is graded B (83/100). Read the Zotero Library safety report
- How do I install Zotero Library?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Zotero Library need an API key?
- Yes. The registry entry asks for
ZOTERO_LIBRARY_ID,ZOTERO_API_KEY,ZOTERO_WEBDAV_URL,ZOTERO_WEBDAV_USERand 1 more. - Is Zotero Library maintained?
- The last commit was 58 days ago (2026-09-07). The latest release is v0.5.0.
- How does Zotero Library compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,255 servers); tools 29 (the typical server has 7); tools that change things 24% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.