roam_search_by_status
Search for TODO or DONE blocks across Roam Research pages. Filter results by page, inclusion terms, or exclusion terms to manage tasks effectively.
Instructions
Search for blocks with a specific status (TODO/DONE) across all pages or within a specific page.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Status to search for (TODO or DONE) | |
| page_title_uid | No | Optional: Title or UID of the page to search in (UID is preferred for accuracy). If not provided, searches across all pages. | |
| include | No | Optional: Comma-separated list of terms to filter results by inclusion (matches content or page title) | |
| exclude | No | Optional: Comma-separated list of terms to filter results by exclusion (matches content or page title) | |
| graph | No | Target graph key from ROAM_GRAPHS config. Defaults to ROAM_DEFAULT_GRAPH. Only needed in multi-graph mode. | |
| write_key | No | Write confirmation key. Required for write operations on non-default graphs when write_key is configured. |