list_snapshots

List a note’s point-in-time snapshots, newest first (id, op, content_hash, size, created_at). response_format=concise returns {id, op, created_at} per snapshot, without content_hash, size and total.

Domain	notes
Scopes	read:notes
Access	read
Tags	read-only, domain:notes
Profile	core, full

Annotations

Annotation	Value
Read-only	yes
Destructive	no
Idempotent	no
Accepts an idempotency key	no

Idempotent is the advisory MCP idempotentHint. Destructive is also yes for a tool that asks for confirmation only on some calls.

Confirmation (human in the loop)

No human confirmation is required to call this tool.

Input

Parameter	Type	Required	Default	Description
vault	string		—	Vault id. May be omitted when only one vault is available. length 1–64; pattern ^[a-z0-9_-]+$
path	string	yes	—	length 1–1024
limit	integer		50	range 1–500
response_format	enum		—	concise returns only the high-signal fields; detailed (the shipped default) returns the full payload. Errors and safety warnings are never trimmed. When omitted, the server’s tools.defaults.responseFormat applies. One of: "concise", "detailed"
verbosity	enum		—	Legacy alias for response_format: terse = concise, full = detailed. One of: "full", "terse"

Output

Field	Type	Always present	Description
vault	string	yes	—
path	string	yes	—
total	number		—
snapshots	object[]	yes	—
snapshots[].id	number	yes	—
snapshots[].content_hash	string		—
snapshots[].op	string	yes	—
snapshots[].size	number		—
snapshots[].created_at	number	yes	—

Related tools

Other tools in the notes domain: append_note, bulk_create_notes, bulk_move_notes, copy_note, delete_note, fetch, get_provenance, list_notes, move_note, note_exists, patch_note, read_note, read_notes, read_resources, read_snapshot, restore_note, snapshot_note, write_note.

Back to the tool catalog.