read_notes
Fetch up to 20 Obsidian notes or spans in one call to avoid repeated single-note requests; cap total text with budgetBytes and get per-item errors.
Instructions
Read up to 20 notes (or spans of them) in one call instead of repeated read_note calls, e.g. the top hits from search, query_notes, list_notes, or get_backlinks. Each item takes the same options as read_note and returns the same fields, in request order. budgetBytes (default 16384) caps the total note text: when the notes exceed it, each is cut to a fair share, marked truncated: true, and keeps noteBytes, so read the rest with read_note. A failing item (missing path, unknown section) returns its own error without failing the batch. contentHash is always the whole file's hash, usable as prevHash.
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": {
"items": "<items>"
},
"name": "read_notes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Notes to read, 1–20. Same options as read_note. | |
| budgetBytes | No | Cap on total note text returned across all items, in UTF-8 bytes (256–65536, default 16384). |