Skip to content

list_properties

Aggregate frontmatter property keys across notes, with usage counts and value types.

Domain metadata
Scopes read:notes
Access read
Tags read-only, domain:metadata
Profile core, full
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_-]+$
folder string — length 1–1024
max_notes integer 5000 range 1–50000
Field Type Always present Description
warnings object[] —
warnings[].path string with parent —
warnings[].reason enum with parent One of: "frontmatter_yaml"
warnings[].message string with parent —
warnings_omitted integer range ≥ -9007199254740991
vault string yes —
notes_scanned integer yes range ≥ -9007199254740991
properties object[] yes —
properties[].key string yes —
properties[].count integer yes range ≥ -9007199254740991
properties[].types string[] yes —

Other tools in the metadata domain: add_tag, bulk_set_property, find_notes_by_property, find_notes_by_tag, get_note_tags, list_tags, read_frontmatter, read_metadata_fields, read_property, remove_tag, suggest_tags, update_frontmatter.

Back to the tool catalog.