Skip to content

list_bookmarks

List the vault’s bookmarks tree (.obsidian/bookmarks.json), preserving groups and unknown fields. Domain: workspace.

Domain workspace
Scopes read:bookmarks
Access read
Tags read-only, domain:workspace
Profile full only
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.

No human confirmation is required to call this tool.

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_-]+$
Field Type Always present Description
vault string yes —
exists boolean yes —
items Record<string, any>[] yes —
count integer yes range ≥ -9007199254740991
content_hash string | null yes —

Other tools in the workspace domain: add_bookmark, append_active_file, append_to_periodic_note, create_periodic_note, delete_active_file, find_or_create_periodic_note, get_active_file, get_periodic_note, list_periodic_notes, list_workspaces, open_workspace, patch_active_file, remove_bookmark, resolve_daily_note, save_workspace, update_active_file.

Back to the tool catalog.