roam_search_for_tag
Search for blocks containing a specific tag in Roam Research. Filter by page or additional tags, with pagination support for managing results.
Instructions
Search for blocks containing a specific tag. Use primary_tag for the tag to find, and optionally page_title_uid to limit search to a specific page. Supports pagination via limit and offset. Use this tool to search for memories tagged with the ROAM_MEMORIES_TAG.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| primary_tag | Yes | The main tag to search for (without the [[ ]] brackets) | |
| page_title_uid | No | Optional: Title or UID of the page to search in (UID is preferred for accuracy). Defaults to today's daily page if not provided. | |
| near_tag | No | Optional: Another tag to filter results by - will only return blocks where both tags appear | |
| case_sensitive | No | Optional: Whether the search should be case-sensitive. If false, it will search for the provided tag, capitalized versions, and first word capitalized versions. | |
| limit | No | Optional: The maximum number of results to return. Defaults to 50. Use -1 for no limit, but be aware that very large results sets can impact performance. | |
| offset | No | Optional: The number of results to skip before returning matches. Useful for pagination. Defaults to 0. | |
| 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. |