search_items
Find tasks using full-text search on title and description. Filter by status, label, or due date. Returns a compact summary by default.
Instructions
Full-text search over items, returning a Compact projection.
The compact, kind-neutral full-text search over items. Returns a
Compact projection by default -- the same small fixed field set per
row as list_items (ref, kind, title, status,
complete_by, parent_id, labels) -- so the heavy body
(description) and the raw id are dropped. Pass full=true for
the rows verbatim.
Scope: full-text search currently covers Tasks only. This tool is
backed by the Tasks search path (GET /tasks/search) because the
backend has no kind-neutral /items/search endpoint today; a
kind-neutral full-text search is a known backend follow-on (to be
filed in the Deferno backend repo, out of scope for the MCP). Non-Task
kinds (Habits / Chores / Events) are therefore not reached by query
yet -- use list_items to enumerate those.
Args:
query: Search query (min 2 characters). Searches title and description.
status: Filter by status (open, in-progress, in-review, done, dropped).
label: Filter by label tag.
from_date: Filter items due on or after this ISO 8601 date.
to_date: Filter items due on or before this ISO 8601 date.
parent_id: Scope search to children of this item (UUID).
full: When true, return every field on each row (no projection).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| status | No | ||
| label | No | ||
| from_date | No | ||
| to_date | No | ||
| parent_id | No | ||
| full | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |