About io.github.oscardvs/zoteus
io.github.oscardvs/zoteus is an MCP server published by oscardvs in the Search category: the everything Zotero MCP server — Web API v3 + local API, safe writes, citations, search.
The repository has 64 stars and 5 forks, with the last commit 2 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
Claude Code
claude mcp add io-github-oscardvs-zoteus -- npx -y @oscardvs/zoteusnpx
npx -y @oscardvs/zoteusFrom source
git clone https://github.com/oscardvs/zoteusThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (37)
search_toolsDiscover the available Zotero tools by keyword — useful for progressive disclosure when you do not want to load every tool definition up front (the code-execution-with-MCP pattern). Pass an optional
Parameters not published.
zotero_annotateAdd or delete Zotero PDF annotations (highlights, underlines, notes), the same objects you create in the Zotero PDF reader.
Parameters not published.
zotero_annotation_digestList the reader\
Parameters not published.
zotero_append_to_noteAdd Markdown to the end of an existing Zotero note, keeping everything already in it, including its own citations and formatting. ${NOTE_MARKDOWN_HELP} \
Parameters not published.
zotero_attach_fileAdd a stored file attachment (e.g. a PDF full text) under an existing item. Give
Parameters not published.
zotero_attachmentUpload, download, or inspect attachment files.
Parameters not published.
zotero_bibliographyProduce a formatted bibliography for items already in a Zotero library, rendered server-side by Zotero in a CSL style (by the desktop app for a library it serves, so no cloud key is needed there; otherwise by the Web API). Provide
Parameters not published.
zotero_create_itemsCreate new items or update existing ones in a single batch (the server auto-chunks into groups of 50).
Parameters not published.
zotero_create_noteCreate a note in Zotero from Markdown: a child note under an item (\
Parameters not published.
zotero_delete_itemsPERMANENTLY and IRREVERSIBLY delete items by key (this purges them; it is NOT the trash). Prefer zotero_trash_items, which is reversible. This tool is disabled unless the server is started with ZOTEUS_ALLOW_DELETE=true, and additionally requires
Parameters not published.
Show all 37 tools
zotero_evidence_tableRender rows of retrieved evidence as a Markdown or CSV table, deterministically, from passages you already retrieved with zotero_get_fulltext and zotero_semantic_search. This tool does NOT search and does NOT read the library: it formats what you pass it and echoes each row\
Parameters not published.
zotero_exportExport items in a bibliographic format and return the raw text. Choose
Parameters not published.
zotero_format_bibliographyRender a formatted bibliography in any CSL style using citeproc-js — no Zotero library write required. Provide either
Parameters not published.
zotero_fulltextNot a search: to find which items contain a term, use
Parameters not published.
zotero_get_fulltextRetrieve an item
Parameters not published.
zotero_get_itemFetch one item by its key, returning the full item record (itemType, all bibliographic fields, creators, tags, collections, relations, version). Optionally set
Parameters not published.
zotero_groupsList the group libraries this server can reach, with each group\
Parameters not published.
zotero_importResolve bibliographic metadata to Zotero item-data and optionally save it to your library.
Parameters not published.
zotero_list_collectionsList collections in a Zotero library (key, name, parent collection key, item count), sorted by name. Read-only: available even in read-only mode (unlike zotero_manage_collections, which also writes). Every collection in the library is read, then
Parameters not published.
zotero_list_tagsList tags in a Zotero library with their usage count and whether each was auto-applied by Zotero. Optional
Parameters not published.
zotero_manage_collectionsList, create, rename, reparent, or delete collections, and move items into or out of a collection. Set
Parameters not published.
zotero_manage_tagsList tags, or add/remove tags on items. Set
Parameters not published.
zotero_merge_itemsMerge one or more duplicate items into a master item: fields the master is MISSING are filled from the duplicates, their tags, collections and relations are unioned onto it, their child notes and attachments are reparented to it, and the emptied duplicates are moved to the trash (recoverable). A field the master already has is never overwritten, and nothing is ever deleted outright. PREVIEWS BY DE
Parameters not published.
zotero_pdf_imagesSee a PDF the way a reader does. Text extraction (zotero_get_fulltext) loses figures, turns tables into run-together numbers, drops most equations, and returns nothing for a scanned page with no text layer; this tool returns pictures instead. Pass a parent
Parameters not published.
zotero_replace_noteReplace the whole content of an existing Zotero note with new Markdown. The note keeps its key, parent item, tags and collections; only its text changes, and the old text is gone from Zotero (Zotero keeps no history of a note). The result returns the previous HTML as \
Parameters not published.
zotero_saved_searchesList, create, or delete saved-search DEFINITIONS. NOTE: the Zotero cloud Web API stores saved searches but does NOT execute them — to get the items a saved search matches, run an equivalent zotero_search_items query (or use the desktop local API when available). Set
Parameters not published.
zotero_schemaReturn the Zotero data model so you never hardcode item shapes. With no arguments, returns the schema version and the list of all item type names. With
Parameters not published.
zotero_scholarExplore the EXTERNAL scholarly graph around a paper (OpenAlex, Crossref fallback). This does NOT search, list, or read your Zotero library: it queries the open web, and results are works from the scholarly web, not your items. To search or inspect YOUR library use zotero_search_items, zotero_semantic_search, zotero_get_item, or zotero_list_tags instead. Provide a
Parameters not published.
zotero_search_itemsSearch or list items in a Zotero library or collection. Quick search via
Parameters not published.
zotero_semantic_searchSearch the library by meaning, not just keywords. Combines BM25 keyword scoring with vector similarity (when an embedding provider is configured) via reciprocal-rank fusion, and returns the best-matching items with a snippet and score. By default it searches item metadata and abstracts; if the index was built with
Parameters not published.
zotero_stylesResolve a human citation-style name to a valid CSL style id and confirm it is available, or list common style aliases.
Parameters not published.
zotero_syncReturn what changed in a library since a given version, for efficient incremental sync. Provide
Parameters not published.
zotero_tag_auditAudit a library against a controlled tag vocabulary with priority tiers. Provide the vocabulary inline as
Parameters not published.
zotero_trash_itemsMove items to the trash (the safe, REVERSIBLE default) or restore them. This sets the
Parameters not published.
zotero_update_itemPartially update one item (HTTP PATCH — only the fields you supply change; omitted fields are preserved). Provide
Parameters not published.
zotero_whoamiResolve the current Zotero identity (userID, username, display name) and per-library access scopes from the configured API key, report the running Zoteus
Parameters not published.
zotero_word_documentWrite a .docx whose citations are LIVE Zotero fields, not plain text: Zotero\
Parameters not published.
Ask AI
✦
Ask AI about io.github.oscardvs/zoteus
Powered by Claude
Ask about io.github.oscardvs/zoteus — answers draw on its README.
Security checks
6 checks have not been run yet.