Zotero Create Annotation
zotero_create_annotationAdds highlights, underlines, area boxes, or sticky notes to Zotero PDFs and EPUBs by attachment key and page, using exact text, normalized rectangle, or note coordinates.
Instructions
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').
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"attachment_key": "<attachment_key>",
"page": "<page>"
},
"name": "zotero_create_annotation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| page | Yes | ||
| rect | No | ||
| tags | No | ||
| text | No | ||
| color | No | #ffd400 | |
| comment | No | ||
| underline | No | ||
| attachment_key | Yes |