Search Tasks
tasks.searchScan an Obsidian vault for markdown tasks and filter by status, priority, due date, recurrence, or tag. Results include task text, source location, and metadata for further manipulation via toggle or update.
Instructions
Scan the vault for Tasks-plugin-style markdown task lines (- [ ] / - [x]) and filter by status, priority, due date range, recurrence, or tag. Result items include the task text, source file, line number, status, and parsed metadata — enough to locate and further manipulate each task via tasks.toggle or tasks.updateMetadata. sortBy controls ordering; limit caps the result count. Read-only. For vault-wide counts without per-task detail, use tasks.stats.
Operates on the session-active vault (see vault.current — selectable via vault.select) unless an explicit vaultPath argument is passed, which always wins.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | `incomplete` = open tasks `[ ]`; `completed` = done `[x]`; `all` = both. | |
| priority | No | Tasks-plugin priority level. | |
| dueBefore | No | Only tasks due strictly before this ISO date. | |
| dueAfter | No | Only tasks due strictly after this ISO date. | |
| dueWithinDays | No | Only tasks due within N days of today (inclusive). | |
| hasRecurrence | No | Filter to recurring (or non-recurring) tasks. | |
| tag | No | Only tasks that carry this tag (leading `#` stripped). | |
| sortBy | No | Result ordering. Default: file then lineNumber. | |
| limit | No | Cap the number of results. Default: 500. | |
| vaultPath | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Number of items in `items`. | |
| items | Yes | List of result items; per-item shape depends on the tool. |