Skip to content

read_metadata_fields

Read a note’s typed metadata fields via the Metadata Menu plugin: returns each configured field’s name, value, type, validity, and source (frontmatter vs inline). Read-only field introspection.

Domain metadata
Scopes read:metadata-menu
Access read
Tags read-only, plugin-bridge, domain:metadata
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_-]+$
path string yes — length 1–1024
Field Type Always present Description
path string yes —
fields Record<string, any> yes —
total integer yes range ≥ 0
vault 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_properties, list_tags, read_frontmatter, read_property, remove_tag, suggest_tags, update_frontmatter.

Back to the tool catalog.