memory-metadata-search · basicmachines-co — Claude Code skill: query notes by metadata

What memory-metadata-search does

Basic Memory keeps structure in YAML frontmatter. Every key you add beyond the standard set (title, type, tags, permalink, schema) is indexed as entity_metadata and can be queried. This skill shows the agent how to build those queries with search_notes.

Filters go into metadata_filters as a JSON dictionary. Supported conditions: equality, list membership with $in, comparisons $gt, $gte, $lt, $lte, inclusive ranges with $between, and nested keys via dot notation such as {"schema.version": "2"}. Several keys combine with AND. Shortcuts exist for tags and status. A text query is optional — you can narrow one with filters or skip it entirely.

Operators need the $ prefix. Drop it and the filter is read as an exact-match key, returning nothing without an error: {"confidence": {"gte": 0.7}} fails where $gte works. Keys follow [A-Za-z0-9_-]+, an operator dict holds exactly one operator, and $between takes only [min, max].