Save a paper's or collection's annotations as a note
zotero_save_annotation_digestSave Zotero annotations as a formatted note with linked highlights, citations, comments, and tags, attached to a paper or filed in a collection for quick review.
Instructions
Gather the annotations zotero_annotation_digest lists and save them as a Zotero note, laid out the way Zotero's own "Add Note from Annotations" lays one out: a paragraph per annotation with the highlighted passage, a citation with its page, the comment and tags. Each highlight stays linked to its spot in the PDF and each citation to its paper, so both open from the note in Zotero. For item_key the note is attached to that paper; for collection_key it is a standalone note filed in that collection, with a heading per paper (up to 200 items; the note says so if the collection holds more). Takes the same types, colors and tags filters. Nothing is written when no annotation matches. Writes go to the running Zotero desktop app (Zotero 10+) for every library it holds, otherwise to the cloud Web API.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "zotero_save_annotation_digest"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Only annotations carrying at least one of these tags (case-insensitive). Default: all. | |
| title | No | The note's heading and title. Default "Annotations (<date>)", or "Annotations: <collection> (<date>)". | |
| types | No | Only these annotation types, e.g. ["highlight", "note"]. Default: all. | |
| colors | No | Only these colours: Zotero's names (yellow, red, green, blue, purple, magenta, orange, gray) or hex values like "#ffd400". Default: all. | |
| item_key | No | A paper (or a standalone PDF/EPUB attachment) whose annotations to gather. Give this or `collection_key`, not both. | |
| note_tags | No | Tags to put on the note itself, e.g. ["annotation-digest"]. | |
| library_id | No | Numeric id of the library to address, e.g. 5234875 for a group (zotero_groups lists the ids you can reach). Omit to use the configured default library; an id given without library_type is read as a group id. | |
| library_type | No | Which library to address: "user" (a personal library) or "group" (a shared group library). Omit to use the library this server is configured for. "group" on its own is refused: pass library_id with it. | |
| collection_key | No | A collection whose top-level items' annotations to gather (from zotero_list_collections; subcollections are not included). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | Key of the note created. | |
| items | Yes | Papers the note covers. | |
| failed | No | One entry per object the write could not land; absent or empty when all of them did. | |
| target | No | Where the write went: "local" (Zotero desktop local API), "desktop" (connector protocol) or "cloud" (Zotero Web API). | |
| version | No | Its version after the write. | |
| truncated | No | True when the collection held more than 200 items and the note covers the first 200 by title. | |
| parentItem | No | The paper the note was attached to, for item_key. | |
| annotations | Yes | Annotations the note holds. | |
| collections | No | Collections the standalone note was filed in. | |
| libraryVersion | No | The library's Last-Modified-Version after this write. |