Search the user's Zotero library for references by keyword, author, tag, item type, year or collection. Returns a ranked list with title, authors, year, venue and the item key needed by the other tools. Use this first for any question about what is in the user's library or to find a paper they have saved.

Fetch the complete record for one or more Zotero items by item key: every metadata field, all creators, tags, collections, attached notes (as plain text) and attachment file paths. Use after zotero_search when you need abstracts, DOIs, notes or the PDF path.

Search the full text of PDFs and notes stored in the library (not just metadata), returning the parent references that contain the phrase. Use when the user asks which of their papers discuss or mention something.

List the library's collections as a tree, with item counts and collection keys.

List the references in a collection, by collection key or (local) name.

List tags used in the library with how many items carry each one.

List the most recently added or modified references — useful for 'what have I saved lately'.

Resolve the on-disk paths of files (PDFs, HTML snapshots) attached to the given items, so the PDF can then be read with the Read tool. Local source only.

Format references as a bibliography or in-text citations in any CSL style (apa, chicago-note-bibliography, ieee, nature, vancouver, …). Uses zotero.org's citation processor when a web API key is configured; otherwise falls back to a plain author–date rendering from local metadata.

List available libraries: local libraries on this machine and group libraries on zotero.org.

Save a new reference to the user's Zotero library via the web API (it then syncs to the desktop app). Requires a configured API key with write access. Ask the user before writing unless they clearly asked you to save something.

Attach a note to an existing Zotero item (or add a standalone note) via the web API. Requires a configured API key with write access.

Create a collection (folder) in the user's Zotero library via the web API, optionally nested under a parent. If a collection with the same name already exists under that parent, its key is returned instead of making a duplicate. Returns the collection key.

Rename a collection and/or move it under another parent (or to the top level) via the web API.

Delete a collection via the web API. The items in it are NOT deleted — they stay in the library and in any other collections. Refuses if the collection has subcollections. Always confirm with the user first.

File existing items into a collection via the web API (items can be in several collections at once; this does not remove them from others). Works in batches, so pass all the keys in one call. Set create=true to make the collection if it doesn't exist.

Take items out of a collection via the web API. The items themselves stay in the library.

Edit an existing item's metadata via the web API: set or clear any fields (title, date, DOI, abstractNote, volume, pages, extra, …), replace its creators, add or remove tags. Only the fields you pass are changed.

Add and/or remove tags on many items at once via the web API.

Rename a tag on every item that carries it (merging into the new name if it already exists), via the web API.

Remove tags from the whole library (from every item) via the web API. Items are untouched otherwise. Confirm with the user first.

Move items to the Zotero trash (recoverable), or restore them from it with restore=true, via the web API. Never deletes permanently. Confirm with the user first.

Report how this connector is configured: data directory, item counts, whether the web API key works, and what to fix if something is missing.