Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ZOTERO_LOCALNoSet to "true" to use local mode, reading straight from zotero.sqlite (requires Zotero 7+ with "Allow other applications on this computer to communicate with Zotero" enabled in Settings → Advanced).
ZOTERO_API_KEYNoZotero web API key, used together with ZOTERO_LIBRARY_ID to write through the web API (needed on Zotero versions before 10, where instead of `zotero-mcp authorize-local`).
ZOTERO_LIBRARY_IDNoZotero library ID, used together with ZOTERO_API_KEY to write through the web API (needed on Zotero versions before 10).
ZOTERO_MCP_TOOLSETSNoSelects which MCP tool groups (toolsets) the server exposes.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
zotero_get_annotationsA

Get PDF/EPUB annotations (highlights and their comments) for one item, or for the whole active library when item_key is omitted (can be thousands, so pass item_key when you know it). item_key: the parent item or an attachment. use_pdf_extraction=True parses the PDF itself when Zotero has no stored annotations (e.g. ones made in another reader). limit: default all. format: 'markdown' (default) or 'json' (normalized records).

zotero_get_notesA

Read notes in the active library. Without query it LISTS notes: an item's child notes with item_key, else notes library-wide. With query it SEARCHES note and annotation text (case-insensitive substring, library-wide, so not with item_key). limit: default 20. truncate=False returns whole bodies (list mode). raw_html=True returns the note's HTML, for editing and passing back to zotero_manage_note(action='update').

zotero_manage_noteA

Create, update or trash a note. item_key: the PARENT item for action='create'; the NOTE's own key for 'update' and 'delete' (zotero_get_notes finds it). note_text: Markdown with $math$ plus (or background-color), or note HTML (sanitized). note_title becomes a heading and tags are optional (create). update REPLACES the body unless append=True; to keep formatting, edit the HTML from zotero_get_notes(raw_html=True) and pass it back whole. delete moves the note to the Trash (recoverable). Notes only: other items go through zotero_delete_item.

zotero_create_annotationA

Annotate a PDF (EPUB: highlights and underlines only). One mode per call: text= highlights that exact text (underline=True underlines it), matched against the text layer (scanned PDFs will not match); rect=[x, y, width, height] draws an area box over a figure or table; note=[x, y] places a sticky note at that point, its text in comment. rect and note are PDF only, normalized 0-1 from the page's top-left: take boxes from zotero_get_page_layout instead of guessing. attachment_key: the attachment, NOT the parent item (zotero_get_item_children lists it). page: 1-indexed (EPUB: chapter). comment, color (hex, default '#ffd400') and tags are optional. Needs PyMuPDF (the [pdf] extra). Example: (attachment_key='NHZFE5A7', page=7, rect=[0.15, 0.22, 0.6, 0.35], comment='Figure 3').

zotero_get_page_layoutA

Detect figure, table and display-equation regions on one PDF page and return their boxes (x, y, width, height, normalized 0-1), each with its caption or equation number, a confidence and a ready-made zotero_create_annotation call. Use it before an area annotation instead of guessing coordinates. Boxes cover the graphic itself: labels inside a figure or unruled table headers can fall outside, and confidence reflects caption matching, not box completeness. attachment_key: the PDF attachment, NOT the parent item (zotero_get_item_children lists it). page: 1-indexed. PDFs only.

zotero_update_annotationA

Update an existing Zotero annotation. Editable fields: text (highlight text), comment, color (hex like '#ffd400'), and tags. Tags can be replaced wholesale via tags, or edited incrementally via add_tags/remove_tags (mutually exclusive with tags). Position/page/sortIndex are anchored to the PDF/EPUB geometry and are not editable.

zotero_delete_annotationA

Permanently delete a Zotero annotation. This cannot be undone. Annotations are deleted outright, as Zotero's own PDF reader does: a trashed annotation stays visible in the reader with no way to remove it there.

zotero_get_item_metadataA

Metadata for ONE item by its 8-character key (not a DOI or title): title, creators, date, DOI, tags, abstract, URL, collections (as keys). format: 'markdown' (default), 'json' (the raw Zotero record) or 'bibtex'. include_abstract=False shortens markdown output. Trashed items are returned too, marked In Trash. To read the paper use zotero_get_item_fulltext; to find items, the search tools.

zotero_get_item_fulltextA

Return the extracted text of an item's PDF or EPUB: most of the paper, often 10K+ tokens. Use it only when the user wants the paper READ, never to search (zotero_semantic_search, zotero_search_items) or for metadata (zotero_get_item_metadata); avoid reading several papers unless asked. item_key: normally the parent item, whose best attachment is picked (PDF first unless attachment_priority says otherwise); an attachment's own key reads exactly that file. PDFs stop at fulltext_display_max_pages (default 10), and a TRUNCATED heading names the pages read: continue with zotero_read_pdf_pages. Scanned PDFs without OCR may return little text.

zotero_get_attachment_pathA

Return the local filesystem path(s) of a Zotero item's attachments. Local mode only. Useful when you want to read a large PDF directly (e.g., a book) instead of going through zotero_get_item_fulltext, which is page-limited.

zotero_get_collectionsA

List every collection in the active library as an indented tree with keys. To find one collection by name, zotero_search_collections is cheaper. limit: default 100, up to 5000. include_trashed=True also shows collections in the Trash.

zotero_get_collection_itemsA

List the items in one collection. detail: 'keys_only', 'summary' (default, no abstracts) or 'full' (with abstracts). include_subcollections=True adds items in nested collections. Page with limit (default 50) and offset; the response names the next offset. To find papers on a topic, zotero_semantic_search is better.

zotero_get_item_childrenA

List the child attachments and notes of one or more items. Use it to get the attachment key that zotero_create_annotation and zotero_get_page_layout need. item_key: one key or an array of keys; pass all of them in one call (a bad key is reported, not fatal). One key shows attachments (type, filename) and notes in full; several show one line per child, grouped by parent.

zotero_get_tagsA

List every tag in the active library, one per line. Use it to find tag names before filtering with zotero_search_items(tag=...) or editing with zotero_batch_update. limit: default all.

zotero_list_librariesA

List the libraries you can switch to: the personal library, group libraries (with group IDs) and, in local mode, RSS feeds, each with its item count. Use it to get an ID for zotero_switch_library. The active library is not marked.

zotero_switch_libraryA

Set the library that every later tool call reads and writes, for the rest of the session. library_id: an ID from zotero_list_libraries ('user' or '0' for the personal library). library_type: 'group' (default), 'user', 'feeds', or 'default' to go back to the configured library (library_id is then ignored). Fails if the library is not accessible.

zotero_get_recentA

List the most recently ADDED items, newest first, in the active library or one collection (collection_key). For 'what did I add lately', not topic search or a collection's full contents. Includes standalone notes and attachments. limit: default 10.

zotero_set_item_parentB

Set or clear the parent of a Zotero item. Pass a parent item key to assign or change the parent, or null to make the item top-level. Zotero validates whether the requested parent-child relationship is allowed.

zotero_authorize_local_writesA

Ask the user to allow writes to the local Zotero library (Zotero 10+). BLOCKS until they answer a dialog in the Zotero app, so tell them to switch to Zotero first. 'Always Allow' saves a reusable key; 'Allow' covers one write. Call it when a write fails and zotero_write_capabilities says local writes are supported but no key is held. app_name: shown in the dialog. timeout: seconds to wait (5-55, default 45). Zotero allows about 5 prompts a minute: do not retry in a loop.

zotero_write_capabilitiesA

Report whether this server can write to Zotero (local API, web API, hybrid, or not at all) and what is missing. Instant; opens no dialog. Call it when a write tool reports no writable backend, before asking the user: if local writes are supported but no key is held, call zotero_authorize_local_writes; otherwise web API credentials are needed.

zotero_read_pdf_pagesA

Read chosen pages of an item's PDF, e.g. after zotero_get_pdf_outline. item_key: the paper or its PDF attachment. Reads start_page through end_page (1-indexed; omit end_page for one page). format='text' (default) returns Markdown and flags pages whose equations, figures or tables the text garbles; format='image' returns PNG page images (up to 10) to read those exactly. rect=[x, y, width, height] (normalized 0-1, e.g. from zotero_get_page_layout) returns just that region of start_page, zoomed in.

zotero_search_itemsA

Keyword search of item metadata: substring match on title, creators and year (qmode='everything' adds abstracts). Keep queries short, like 'Brewer 2011' or a surname: every extra word narrows the match. For topics or concepts use zotero_semantic_search. If nothing matches it retries simpler queries, then semantic search, and says so. tag: conditions that are ANDed; within one, ' OR ' alternates and a leading '-' excludes, e.g. ['methods OR methodology', '-draft']. Omit query to list items by tag alone (zotero_get_tags lists the names). item_type: '-attachment' (default) excludes attachments, or e.g. 'journalArticle'. limit: default 10. collection_key: search one collection (no retries); include_subcollections adds its subcollections. search_all_libraries=True searches every library and labels each result; needs a query, not with collection_key.

zotero_search_by_citation_keyA

Find the one item with this BetterBibTeX citation key (exact, case-sensitive), e.g. 'smith2024'. Checks Zotero's citationKey field, then 'Citation Key:' lines in Extra. For partial keys or free text use zotero_search_items.

zotero_advanced_searchA

Search with structured field conditions, for what zotero_search_items cannot express: date ranges, item types, matches on one field. conditions: a list of {field, operation, value}. Fields include title, creator, date, dateAdded, dateModified, tag, itemType, publicationTitle, abstractNote, collection. Operations: is, isNot, contains, doesNotContain, beginsWith, endsWith, isGreaterThan, isLessThan, isBefore, isAfter. Dates are ISO; 'added in the last 30 days' is dateAdded isAfter . join_mode: 'all' (AND, default) or 'any' (OR). sort_by: a field such as dateAdded or title; sort_direction: 'asc' (default) or 'desc'. limit: default 50, max 500. include_subcollections=True makes collection is/isNot match the whole subtree. search_all_libraries=True searches every library (no collection conditions). Example: conditions=[{'field': 'itemType', 'operation': 'is', 'value': 'preprint'}, {'field': 'dateAdded', 'operation': 'isAfter', 'value': '2026-03-22'}].

zotero_synthesize_annotationsA

Gather highlights, comments and child notes across a scope into a per-paper digest for YOU to synthesize; no LLM is called. collection_key: only papers in that collection; omit for the whole active library. tag: a tag or list of tags to filter papers by. limit: annotations and notes scanned (default 200). format: 'markdown' (default, grouped by paper with a count summary) or 'json'. Use it before writing a thematic review.

zotero_export_bibliographyA

Format references with Zotero's CSL engine. item_keys: up to 100 item keys (takes precedence); or collection_key; neither exports the active library's top-level items. style: a CSL style short name (default 'apa'; e.g. 'modern-language-association', 'chicago-note-bibliography', 'ieee'). export_format: 'bib' (reference list, default), 'citation' (in-text citations) or 'bibtex'.

zotero_batch_updateA

Edit many items in one call: add or remove tags, and set or remove Key: value lines in Extra (BetterBibTeX keys, tex.* fields). Select by item_keys, or by query and/or tag (ANDed; a list of tags ORs); item_keys wins. Needs a selector and an action. add_tags/remove_tags leave other tags alone. set_keys upserts Extra lines by case-insensitive key; remove_keys deletes them. limit: items selected by query/tag (default 50, up to 1000); the report says if more matched. Example: (tag='to-read', add_tags=['reviewed'], remove_tags=['to-read']).

zotero_manage_collectionA

Create, update or delete a collection. action='create': name, and optionally parent_collection for a subcollection. 'update': collection_key plus a new name, a new parent_collection, or to_top_level=True; the key, items and subcollections are kept, and a collection cannot move under itself or its own subcollection. 'delete': collection_key; permanent (Zotero does not trash collections) and takes its subcollections with it, but the items stay in the library. parent_collection: a key, name or 'Parent/Child' path. To file items into collections use zotero_set_item_collections.

zotero_search_collectionsA

Find collections by name in the active library; returns their keys and parents. Case-insensitive substring on the collection's own name, and every word must match ('reading list' needs both). include_trashed=True also matches collections in the Trash.

zotero_set_item_collectionsA

Add items to, or remove them from, collections, leaving their other memberships alone. item_keys: an array of item keys. add_to / remove_from: arrays of collection keys, names or 'Parent/Child' paths, all checked before anything changes. To replace memberships wholesale use zotero_update_item; to create, rename or delete a collection, zotero_manage_collection.

zotero_update_itemA

Change metadata on one item; only what you pass changes. fields: {name: value} with snake_case names (title, date, doi, url, abstract, publication_title, short_title, book_title, citation_key, item_type, place, extra, volume, issue, pages, publisher, issn, isbn, edition, language, access_date) or raw Zotero field names. Unknown names fail and list the valid ones; names the item's type lacks are skipped and reported. citation_key sets the BetterBibTeX key; item_type converts the item, dropping fields the new type lacks. creators: a full replacement list of {creatorType, firstName, lastName}. tags REPLACES all tags; add_tags/remove_tags edit incrementally (preferred; not with tags). collections (keys) or collection_names REPLACE membership (collections=[] clears it); for incremental moves use zotero_set_item_collections. For notes use zotero_manage_note.

zotero_delete_itemA

Move an item to the Trash (recoverable in Zotero). Any item type, but for notes use zotero_manage_note(action='delete'), or pass allow_note=True.

zotero_get_pdf_outlineA

Return a PDF's table of contents with page numbers, usually under 200 tokens: find the pages you need, then read them with zotero_read_pdf_pages instead of the full text. item_key: the parent item or the PDF attachment. Says so when the PDF has no outline. PDFs only; needs PyMuPDF (the [pdf] extra).

zotero_attach_fileA

Attach a file to an EXISTING regular item (not an attachment or note). To create a new item from a file, use zotero_add_item(source=). Give exactly one of file_path (absolute; any regular file, no symlinks or .lnk) or url (a direct PDF link, downloaded by the server). filename: overrides the stored name. link_mode: 'import' (default) uploads a copy, which counts against Zotero storage unless WebDAV is set up; 'linked' links the file where it is (file_path only, nothing copied). Skips the upload when the item already has the same file. Returns the attachment key.

zotero_add_itemA

Add items from a DOI, URL, ISBN, PMID, BibTeX, CSL JSON or a local file; use it for every 'add this to Zotero' request. source: the identifier, URL, citation text or ABSOLUTE file path. DOI/URL/ISBN/PMID also take a comma- or newline-separated batch; BibTeX and CSL JSON may be inline (many entries) or a .bib/.json path. source_type: 'auto' (default) detects it. Prefer a DOI: a URL other than doi.org or arxiv.org becomes a bare webpage item, and ISBN metadata is noisy (verify it). For a file, its DOI is looked up, else metadata is guessed, then the file is attached; title overrides a missed title. collections: keys, names or 'Parent/Child' paths, checked before anything is created (create_missing_collections=True makes missing ones). if_exists: 'file' (default) reuses an item with the same DOI/arXiv ID/ISBN/URL, adding missing collections and tags; 'duplicate' always creates; 'skip' leaves a match alone. attach_mode: 'auto' (default) attaches an open-access PDF, 'linked_url' links it, 'none' skips, 'required' fails without one.

Prompts

Interactive templates invoked by user choice

NameDescription
zotero_literature_reviewRun a structured literature review on a topic using the Zotero library.
zotero_synthesize_my_notesSynthesize your own highlights and notes across a topic or collection.
zotero_find_contradicting_evidenceStress-test a claim by finding supporting and contradicting papers.
zotero_expand_from_paperSnowball a reading list outward from one seed paper via its citation graph.

Resources

Contextual data attached and managed by the client

NameDescription
Zotero collectionsAll collections in the active Zotero library (name, key, item count).

TDQS

A3.9/5.0

Scored across 35 tools

Disambiguation4/5

The tool set is broad, but descriptions generally route clearly between close areas: notes vs annotations vs synthesized digests, keyword vs advanced vs citation-key search, and item vs collection membership edits. A few boundaries remain fussy, especially update_item vs batch_update vs set_item_collections, and references to a missing semantic search add some confusion.

Naming Consistency4/5

Almost all tools use the zotero_ prefix, snake_case, and a predictable verb-first pattern such as get_, search_, create_, update_, delete_, manage_, and list_. Minor deviations like zotero_write_capabilities and multi-action manage_ names are still readable and consistent enough.

Tool Count2/5

35 tools is heavy for one MCP server, even for a broad domain like Zotero. Several specialized operations such as set_item_parent, get_page_layout, get_attachment_path, and write_capabilities push the surface well past a well-scoped range, increasing selection overhead.

Completeness4/5

The surface covers item CRUD, collections, notes, annotations, PDF reading/outlining, bibliography export, library switching, and write authorization. The main gap is that multiple descriptions point agents to zotero_semantic_search, but that tool is not present in the provided set.

Maintenance

ActivityActive
ResponsivenessNo recent community issues