vault_query
Query Obsidian notes by frontmatter metadata (type, status, tags, dates, custom fields) with sorting and folder limits. Results include clickable links to open notes in Obsidian.
Instructions
Query notes by YAML frontmatter metadata (type, status, tags, dates, custom fields, sorting). Paths in this tool's output are formatted as markdown links [vault-relative-path.md](obsidian://...) so users can Cmd/Ctrl-click to open in Obsidian. Preserve the link form when relaying paths to the user; pass only the bracket text (e.g. 01-Projects/Foo/note.md) to other vault tools' path arguments, never the full markdown link.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | ALL tags must be present (case-insensitive) | |
| type | No | Filter by note type (exact match) | |
| limit | No | Max results to return | |
| folder | No | Limit search to this folder (supports partial names, e.g. 'MyApp') | |
| status | No | Filter by status (exact match) | |
| sort_by | No | Sort results by this frontmatter field. Smart ordering: priority uses rank (urgent>high>normal>low), dates sort chronologically, others alphabetically. Nulls sort last. | |
| tags_any | No | ANY tag must be present (case-insensitive) | |
| sort_order | No | Sort direction (default: asc) | asc |
| created_after | No | Notes created on or after this date (YYYY-MM-DD) | |
| custom_fields | No | Filter by arbitrary frontmatter fields (exact match). Use null to match missing fields. | |
| created_before | No | Notes created on or before this date (YYYY-MM-DD) |