Skip to content

remove_tag

Remove a tag from a note’s frontmatter, its body, or both (exact, not hierarchical).

Domain metadata
Scopes write:notes
Access write
Tags writes, domain:metadata
Profile core, full
Annotation Value
Read-only no
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
tag string yes — length ≥ 1
location enum "all" One of: "frontmatter", "inline", "all"
prev_hash string — —
Field Type Always present Description
vault string yes —
path string yes —
tag string yes —
location enum yes One of: "frontmatter", "inline", "all"
removed integer yes range ≥ -9007199254740991
content_hash string yes —
prev_hash 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_metadata_fields, read_property, suggest_tags, update_frontmatter.

Back to the tool catalog.