Find files
bm_findRead-onlyIdempotent
Find files recursively in a Basic Memory project by filename glob or frontmatter filters, and return selected fields. Limit searches to a folder or project.
Instructions
Find files in a Basic Memory project, recursively. With name, match file names against a glob ('meeting'). With filters, match notes by frontmatter, e.g. {"status": "active"} or {"priority": {"$in": ["high"]}}, and with fields return just those frontmatter values per note. path limits the search to a folder. For ranked text or meaning search, use bm_search.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | File-name glob, e.g. '*.md'. Not with `filters`. | |
| page | No | Page number. | |
| path | No | A directory in the project, e.g. 'specs' or 'specs/active'. '/' is the project root; '<project>/path' addresses another project. | / |
| depth | No | Folder levels to search (1-10). | |
| fields | No | Frontmatter fields to return per note (dot paths allowed), e.g. ["title", "priority"]. Needs `filters`. | |
| filters | No | Frontmatter filters as {field: condition}. Nested fields use dot notation ("schema.confidence"). A condition is a value for equality ({"status": "draft"}), null for absent-or-null ({"owner": null}), a list for contains-all ({"tags": ["a", "b"]}), or an operator object with $gt, $gte, $lt, $lte, $in, $between, $contains or $exists, e.g. {"priority": {"$in": ["high"]}}. Several operators on one field AND together. | |
| project | No | Project name, 'workspace/project', or project external id. Omit to use the default project. | |
| page_size | No | Results per page (1-100). | |
| output_format | No | text |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |