Get annotations
Highlights and comments made in the PDFs of an item, with color and page.
MCP tool zotero_read → get_annotations
read
Returns the annotations of every PDF attached to the item, in page order, each with its text, comment, color and page. Items without a PDF or without annotations return an empty list. It reads annotations only and never changes the PDF.
Parameters
| Name | Type | Description |
|---|---|---|
| library string | string | 'me' for My Library (default) or a group library ID from list_libraries. |
| item_key string required | string | Item key from search_items, 8 characters. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "zotero_read",
"arguments": {
"operation": "get_annotations",
"arguments": {
"item_key": "item key"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"item_key": "H6R2VB5D",
"annotations": [
{
"type": "highlight",
"color": "yellow",
"page": 4,
"text": "Attention cost grows linearly with window size.",
"comment": ""
},
{
"type": "highlight",
"color": "red",
"page": 12,
"text": "Evaluation uses one dataset.",
"comment": "Check the appendix."
}
]
},
"isError": false
}