zotero-rag
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ZOTERO_DIR | No | Folder containing the Zotero data (zotero.sqlite and PDF storage). | ~/Zotero |
| EMBED_MODEL | No | Embedding model name. Changing this requires a full reindex. | BAAI/bge-m3 |
| RERANK_MODEL | No | Reranker model name; set to an empty string to disable reranking. | BAAI/bge-reranker-v2-m3 |
| ZOTERO_BASE_DIR | No | Base folder for 'linked' attachment files. | |
| ZOTERO_RAG_DATA | No | Directory for the RAG index (data/index.sqlite). | ./data |
| EMBED_DOC_PREFIX | No | Prefix added to documents, e.g. 'passage: ' (for multilingual-e5 models). | |
| EMBED_QUERY_PREFIX | No | Prefix added to queries, e.g. 'query: ' (for multilingual-e5 models). |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_libraryA | Hybrid semantic + keyword search over the full text of PDFs in the Zotero library. Returns the best matching passages with author, year, title, page and a zotero:// link. query: what to look for, in Polish or English (searching both languages often helps). author/tag/collection: case-insensitive substring match. item_type: e.g. journalArticle, book, thesis. per_item: max passages per work (raise it when studying a single source). |
| search_within_itemB | Search inside one work only (item_key from search results or list_items). |
| get_contextC | Passages around passage |
| get_itemB | Full bibliographic record of one work: authors, year, venue, DOI, tags, collections, abstract. |
| list_itemsB | List indexed works (optionally filtered), one per line: item_key, citation, title. |
| index_statusA | How many works and passages are indexed, with which model, plus collections and top tags. |
| update_indexA | Index PDFs added or changed in Zotero since the last run (can take a few minutes for many new files). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a distinct retrieval concern: library-wide search, single-item search, context expansion, metadata, listing, status, and indexing. The only mild overlap is search_library vs search_within_item, but their descriptions clearly delineate scope (whole library vs one work).
All names are snake_case and mostly follow a verb_noun pattern (search_library, get_item, list_items, update_index). The lone noun_phrase outlier is index_status, a minor deviation that remains readable and predictable.
Seven tools is well-scoped for a RAG search server, with each tool earning its place across search, retrieval, metadata, and index management. Nothing feels redundant or padded.
The surface covers the core lifecycle: search, context expansion, metadata retrieval, listing, status, and index updates. Minor gaps exist (e.g., no per-item deletion or citation export), but these are workarounds rather than dead ends for typical workflows.