roam_search_for_tag

Search for blocks with a specific tag in Roam Research and optionally filter by a nearby tag. Use it to locate tagged content efficiently within your graph.

Instructions

Search for blocks containing a specific tag and optionally filter by blocks that also contain another tag nearby. Example: Use this to search for memories that are tagged with the MEMORIES_TAG.

Input Schema

Name	Required	Description
`near_tag`	No	Optional: Another tag to filter results by - will only return blocks where both tags appear
`page_title_uid`	No	Optional: Title or UID of the page to search in. Defaults to today's daily page if not provided
`primary_tag`	Yes	The main tag to search for (without the [[ ]] brackets)

Input Schema (JSON Schema)

{
  "properties": {
    "near_tag": {
      "description": "Optional: Another tag to filter results by - will only return blocks where both tags appear",
      "type": "string"
    },
    "page_title_uid": {
      "description": "Optional: Title or UID of the page to search in. Defaults to today's daily page if not provided",
      "type": "string"
    },
    "primary_tag": {
      "description": "The main tag to search for (without the [[ ]] brackets)",
      "type": "string"
    }
  },
  "required": [
    "primary_tag"
  ],
  "type": "object"
}

Roam Research

roam_search_for_tag

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Roam Research

Related Tools