roam research mcp

[
  {
    "description": "Add a list of todo items as individual blocks to today's daily page in Roam. Each item becomes its own actionable block with todo status.nNOTE on Roam-flavored markdown: For direct linking: use [[link]] syntax. For aliased linking, use [alias]([[link]]) syntax. Do not concatenate words in links/hashtags - correct: #[[multiple words]] #self-esteem (for typically hyphenated words).",
    "inputSchema": {
      "properties": {
        "todos": {
          "description": "List of todo items to add",
          "items": {
            "description": "Todo item text",
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "todos"
      ],
      "type": "object"
    },
    "name": "roam_add_todo"
  },
  {
    "description": "Retrieve complete page contents by exact title, including all nested blocks and resolved block references. Use for accessing daily pages, reading and analyzing existing Roam pages.",
    "inputSchema": {
      "properties": {
        "title": {
          "description": "Title of the page. For date pages, use ordinal date formats such as January 2nd, 2025",
          "type": "string"
        }
      },
      "required": [
        "title"
      ],
      "type": "object"
    },
    "name": "roam_fetch_page_by_title"
  },
  {
    "description": "Create a new standalone page in Roam with optional content using explicit nesting levels. Best for:n- Creating foundational concept pages that other pages will link to/fromn- Establishing new topic areas that need their own namespacen- Setting up reference materials or documentationn- Making permanent collections of information.",
    "inputSchema": {
      "properties": {
        "content": {
          "description": "Initial content for the page as an array of blocks with explicit nesting levels",
          "items": {
            "properties": {
              "level": {
                "description": "Indentation level (1-10, where 1 is top level)",
                "maximum": 10,
                "minimum": 1,
                "type": "integer"
              },
              "text": {
                "description": "Content of the block",
                "type": "string"
              }
            },
            "required": [
              "text",
              "level"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "title": {
          "description": "Title of the new page",
          "type": "string"
        }
      },
      "required": [
        "title"
      ],
      "type": "object"
    },
    "name": "roam_create_page"
  },
  {
    "description": "Add a new block to an existing Roam page. If no page specified, adds to today's daily note. Best for capturing immediate thoughts, additions to discussions, or content that doesn't warrant its own page. Can specify page by title or UID.nNOTE on Roam-flavored markdown: For direct linking: use [[link]] syntax. For aliased linking, use [alias]([[link]]) syntax. Do not concatenate words in links/hashtags - correct: #[[multiple words]] #self-esteem (for typically hyphenated words).",
    "inputSchema": {
      "properties": {
        "content": {
          "description": "Content of the block",
          "type": "string"
        },
        "page_uid": {
          "description": "Optional: UID of the page to add block to",
          "type": "string"
        },
        "title": {
          "description": "Optional: Title of the page to add block to (defaults to today's date if neither page_uid nor title provided)",
          "type": "string"
        }
      },
      "required": [
        "content"
      ],
      "type": "object"
    },
    "name": "roam_create_block"
  },
  {
    "description": "Add a structured outline to an existing page or block (by title text or uid), with customizable nesting levels. Best for:n- Adding supplementary structured content to existing pagesn- Creating temporary or working outlines (meeting notes, brainstorms)n- Organizing thoughts or research under a specific topicn- Breaking down subtopics or components of a larger concept",
    "inputSchema": {
      "properties": {
        "block_text_uid": {
          "description": "A relevant title heading for the outline (or UID, if known) of the block under which outline content will be nested. If blank, content will be nested under the page title.",
          "type": "string"
        },
        "outline": {
          "description": "Array of outline items with block text and explicit nesting level",
          "items": {
            "properties": {
              "level": {
                "description": "Indentation level (1-10, where 1 is top level)",
                "maximum": 10,
                "minimum": 1,
                "type": "integer"
              },
              "text": {
                "description": "Content of the block",
                "type": "string"
              }
            },
            "required": [
              "text",
              "level"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "page_title_uid": {
          "description": "Title (or UID if known) of the page. Leave blank to use the default daily page",
          "type": "string"
        }
      },
      "required": [
        "outline"
      ],
      "type": "object"
    },
    "name": "roam_create_outline"
  },
  {
    "description": "Import nested markdown content into Roam under a specific block. Can locate the parent block by UID or by exact string match within a specific page.",
    "inputSchema": {
      "properties": {
        "content": {
          "description": "Nested markdown content to import",
          "type": "string"
        },
        "order": {
          "default": "first",
          "description": "Optional: Where to add the content under the parent ("first" or "last")",
          "enum": [
            "first",
            "last"
          ],
          "type": "string"
        },
        "page_title": {
          "description": "Optional: Title of the page containing the parent block (ignored if page_uid provided)",
          "type": "string"
        },
        "page_uid": {
          "description": "Optional: UID of the page containing the parent block",
          "type": "string"
        },
        "parent_string": {
          "description": "Optional: Exact string content of the parent block to add content under (must provide either page_uid or page_title)",
          "type": "string"
        },
        "parent_uid": {
          "description": "Optional: UID of the parent block to add content under",
          "type": "string"
        }
      },
      "required": [
        "content"
      ],
      "type": "object"
    },
    "name": "roam_import_markdown"
  },
  {
    "description": "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.",
    "inputSchema": {
      "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"
    },
    "name": "roam_search_for_tag"
  },
  {
    "description": "Search for blocks with a specific status (TODO/DONE) across all pages or within a specific page.",
    "inputSchema": {
      "properties": {
        "exclude": {
          "description": "Optional: Comma-separated list of terms to filter results by exclusion (matches content or page title)",
          "type": "string"
        },
        "include": {
          "description": "Optional: Comma-separated list of terms to filter results by inclusion (matches content or page title)",
          "type": "string"
        },
        "page_title_uid": {
          "description": "Optional: Title or UID of the page to search in. If not provided, searches across all pages",
          "type": "string"
        },
        "status": {
          "description": "Status to search for (TODO or DONE)",
          "enum": [
            "TODO",
            "DONE"
          ],
          "type": "string"
        }
      },
      "required": [
        "status"
      ],
      "type": "object"
    },
    "name": "roam_search_by_status"
  },
  {
    "description": "Search for block references within a page or across the entire graph. Can search for references to a specific block or find all block references.",
    "inputSchema": {
      "properties": {
        "block_uid": {
          "description": "Optional: UID of the block to find references to",
          "type": "string"
        },
        "page_title_uid": {
          "description": "Optional: Title or UID of the page to search in. If not provided, searches across all pages",
          "type": "string"
        }
      },
      "type": "object"
    },
    "name": "roam_search_block_refs"
  },
  {
    "description": "Search for parent or child blocks in the block hierarchy. Can search up or down the hierarchy from a given block.",
    "inputSchema": {
      "oneOf": [
        {
          "required": [
            "parent_uid"
          ]
        },
        {
          "required": [
            "child_uid"
          ]
        }
      ],
      "properties": {
        "child_uid": {
          "description": "Optional: UID of the block to find parents of",
          "type": "string"
        },
        "max_depth": {
          "description": "Optional: How many levels deep to search (default: 1)",
          "maximum": 10,
          "minimum": 1,
          "type": "integer"
        },
        "page_title_uid": {
          "description": "Optional: Title or UID of the page to search in",
          "type": "string"
        },
        "parent_uid": {
          "description": "Optional: UID of the block to find children of",
          "type": "string"
        }
      },
      "type": "object"
    },
    "name": "roam_search_hierarchy"
  },
  {
    "description": "Find pages that have been modified today (since midnight), with limit.",
    "inputSchema": {
      "properties": {
        "max_num_pages": {
          "default": 50,
          "description": "Max number of pages to retrieve (default: 50)",
          "type": "integer"
        }
      },
      "type": "object"
    },
    "name": "roam_find_pages_modified_today"
  },
  {
    "description": "Search for blocks containing specific text across all pages or within a specific page.",
    "inputSchema": {
      "properties": {
        "page_title_uid": {
          "description": "Optional: Title or UID of the page to search in. If not provided, searches across all pages",
          "type": "string"
        },
        "text": {
          "description": "The text to search for",
          "type": "string"
        }
      },
      "required": [
        "text"
      ],
      "type": "object"
    },
    "name": "roam_search_by_text"
  },
  {
    "description": "Update a single block identified by its UID. Use this for individual block updates when you need to either replace the entire content or apply a transform pattern to modify specific parts of the content.nNOTE on Roam-flavored markdown: For direct linking: use [[link]] syntax. For aliased linking, use [alias]([[link]]) syntax. Do not concatenate words in links/hashtags - correct: #[[multiple words]] #self-esteem (for typically hyphenated words).",
    "inputSchema": {
      "oneOf": [
        {
          "required": [
            "content"
          ]
        },
        {
          "required": [
            "transform_pattern"
          ]
        }
      ],
      "properties": {
        "block_uid": {
          "description": "UID of the block to update",
          "type": "string"
        },
        "content": {
          "description": "New content for the block. If not provided, transform_pattern will be used.",
          "type": "string"
        },
        "transform_pattern": {
          "description": "Pattern to transform the current content. Used if content is not provided.",
          "properties": {
            "find": {
              "description": "Text or regex pattern to find",
              "type": "string"
            },
            "global": {
              "default": true,
              "description": "Whether to replace all occurrences",
              "type": "boolean"
            },
            "replace": {
              "description": "Text to replace with",
              "type": "string"
            }
          },
          "required": [
            "find",
            "replace"
          ],
          "type": "object"
        }
      },
      "required": [
        "block_uid"
      ],
      "type": "object"
    },
    "name": "roam_update_block"
  },
  {
    "description": "Efficiently update multiple blocks in a single batch operation. Use this when you need to update several blocks at once to avoid making multiple separate API calls. Each block in the batch can independently either have its content replaced or transformed using a pattern.nNOTE on Roam-flavored markdown: For direct linking: use [[link]] syntax. For aliased linking, use [alias]([[link]]) syntax. Do not concatenate words in links/hashtags - correct: #[[multiple words]] #self-esteem (for typically hyphenated words).",
    "inputSchema": {
      "properties": {
        "updates": {
          "description": "Array of block updates to perform",
          "items": {
            "oneOf": [
              {
                "required": [
                  "content"
                ]
              },
              {
                "required": [
                  "transform"
                ]
              }
            ],
            "properties": {
              "block_uid": {
                "description": "UID of the block to update",
                "type": "string"
              },
              "content": {
                "description": "New content for the block. If not provided, transform will be used.",
                "type": "string"
              },
              "transform": {
                "description": "Pattern to transform the current content. Used if content is not provided.",
                "properties": {
                  "find": {
                    "description": "Text or regex pattern to find",
                    "type": "string"
                  },
                  "global": {
                    "default": true,
                    "description": "Whether to replace all occurrences",
                    "type": "boolean"
                  },
                  "replace": {
                    "description": "Text to replace with",
                    "type": "string"
                  }
                },
                "required": [
                  "find",
                  "replace"
                ],
                "type": "object"
              }
            },
            "required": [
              "block_uid"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "updates"
      ],
      "type": "object"
    },
    "name": "roam_update_multiple_blocks"
  },
  {
    "description": "Search for blocks or pages based on creation or modification dates. Not for daily pages with ordinal date titles.",
    "inputSchema": {
      "properties": {
        "end_date": {
          "description": "Optional: End date in ISO format (YYYY-MM-DD)",
          "type": "string"
        },
        "include_content": {
          "default": true,
          "description": "Whether to include the content of matching blocks/pages",
          "type": "boolean"
        },
        "scope": {
          "description": "Whether to search blocks, pages, or both",
          "enum": [
            "blocks",
            "pages",
            "both"
          ],
          "type": "string"
        },
        "start_date": {
          "description": "Start date in ISO format (YYYY-MM-DD)",
          "type": "string"
        },
        "type": {
          "description": "Whether to search by creation date, modification date, or both",
          "enum": [
            "created",
            "modified",
            "both"
          ],
          "type": "string"
        }
      },
      "required": [
        "start_date",
        "type",
        "scope"
      ],
      "type": "object"
    },
    "name": "roam_search_by_date"
  },
  {
    "description": "Add a memory or piece of information to remember, stored on the daily page with MEMORIES_TAG tag and optional categories. nNOTE on Roam-flavored markdown: For direct linking: use [[link]] syntax. For aliased linking, use [alias]([[link]]) syntax. Do not concatenate words in links/hashtags - correct: #[[multiple words]] #self-esteem (for typically hyphenated words).",
    "inputSchema": {
      "properties": {
        "categories": {
          "description": "Optional categories to tag the memory with (will be converted to Roam tags)",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "memory": {
          "description": "The memory detail or information to remember",
          "type": "string"
        }
      },
      "required": [
        "memory"
      ],
      "type": "object"
    },
    "name": "roam_remember"
  },
  {
    "description": "Retrieve all stored memories on page titled MEMORIES_TAG, or tagged block content with the same name. Returns a combined, deduplicated list of memories. Optionally filter blcoks with a specified tag and sort by creation date.",
    "inputSchema": {
      "properties": {
        "filter_tag": {
          "description": "Include only memories with a specific filter tag. For single word tags use format "tag", for multi-word tags use format "tag word" (without brackets)",
          "type": "string"
        },
        "sort_by": {
          "default": "newest",
          "description": "Sort order for memories based on creation date",
          "enum": [
            "newest",
            "oldest"
          ],
          "type": "string"
        }
      },
      "type": "object"
    },
    "name": "roam_recall"
  },
  {
    "description": "Execute a custom Datomic query on the Roam graph beyond the available search tools. This provides direct access to Roam's query engine for advanced data retrieval. Note: Roam graph is case-sensitive.nList of some of Roam's data model Namespaces and Attributes: ancestor (descendants), attrs (lookup), block (children, heading, open, order, page, parents, props, refs, string, text-align, uid), children (view-type), create (email, time), descendant (ancestors), edit (email, seen-by, time), entity (attrs), log (id), node (title), page (uid, title), refs (text).nPredicates (clojure.string/includes?, clojure.string/starts-with?, clojure.string/ends-with?, <, >, <=, >=, =, not=, !=).nAggregates (distinct, count, sum, max, min, avg, limit).nTips: Use :block/parents for all ancestor levels, :block/children for direct descendants only; combine clojure.string for complex matching, use distinct to deduplicate, leverage Pull patterns for hierarchies, handle case-sensitivity carefully, and chain ancestry rules for multi-level queries.",
    "inputSchema": {
      "properties": {
        "inputs": {
          "description": "Optional array of input parameters for the query",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "query": {
          "description": "The Datomic query to execute (in Datalog syntax)",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "roam_datomic_query"
  }
]