roam-research-mcp 0.24.2 → 0.24.5

package/build/server/roam-server.js

@@ -17,7 +17,7 @@ export class RoamServer {
         this.toolHandlers = new ToolHandlers(this.graph);
         this.server = new Server({
             name: 'roam-research',
-            version: '0.24.2',
+            version: '0.24.5',
         }, {
             capabilities: {
                 tools: {
@@ -36,7 +36,7 @@ export class RoamServer {
                     roam_find_pages_modified_today: {},
                     roam_search_by_text: {},
                     roam_update_block: {},
-                    roam_update_blocks: {},
+                    roam_update_multiple_blocks: {},
                     roam_search_by_date: {},
                     roam_datomic_query: {}
                 },
@@ -137,7 +137,8 @@ export class RoamServer {
                         };
                     }
                     case 'roam_find_pages_modified_today': {
-                        const result = await this.toolHandlers.findPagesModifiedToday();
+                        const { max_num_pages } = request.params.arguments;
+                        const result = await this.toolHandlers.findPagesModifiedToday(max_num_pages || 50);
                         return {
                             content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                         };
@@ -179,7 +180,7 @@ export class RoamServer {
                             content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                         };
                     }
-                    case 'roam_update_blocks': {
+                    case 'roam_update_multiple_blocks': {
                         const { updates } = request.params.arguments;
                         const result = await this.toolHandlers.updateBlocks(updates);
                         return {

package/build/tools/operations/outline.js

@@ -159,6 +159,10 @@ export class OutlineOperations {
                 return createAndVerifyBlock(content, parentUid, maxRetries, initialDelay, true);
             }
         };
+        // Helper function to check if string is a valid Roam UID (9 characters)
+        const isValidUid = (str) => {
+            return typeof str === 'string' && str.length === 9;
+        };
         // Get or create the parent block
         let targetParentUid;
         if (!block_text_uid) {
@@ -166,12 +170,28 @@ export class OutlineOperations {
         }
         else {
             try {
-                // Create header block and get its UID
-                targetParentUid = await createAndVerifyBlock(block_text_uid, targetPageUid);
+                if (isValidUid(block_text_uid)) {
+                    // First try to find block by UID
+                    const uidQuery = `[:find ?uid
+                           :where [?e :block/uid "${block_text_uid}"]
+                                  [?e :block/uid ?uid]]`;
+                    const uidResult = await q(this.graph, uidQuery, []);
+                    if (uidResult && uidResult.length > 0) {
+                        // Use existing block if found
+                        targetParentUid = uidResult[0][0];
+                    }
+                    else {
+                        throw new McpError(ErrorCode.InvalidRequest, `Block with UID "${block_text_uid}" not found`);
+                    }
+                }
+                else {
+                    // Create header block and get its UID if not a valid UID
+                    targetParentUid = await createAndVerifyBlock(block_text_uid, targetPageUid);
+                }
             }
             catch (error) {
                 const errorMessage = error instanceof Error ? error.message : String(error);
-                throw new McpError(ErrorCode.InternalError, `Failed to create header block "${block_text_uid}": ${errorMessage}`);
+                throw new McpError(ErrorCode.InternalError, `Failed to ${isValidUid(block_text_uid) ? 'find' : 'create'} block "${block_text_uid}": ${errorMessage}`);
             }
         }
         // Initialize result variable

package/build/tools/operations/pages.js

@@ -8,7 +8,7 @@ export class PageOperations {
     constructor(graph) {
         this.graph = graph;
     }
-    async findPagesModifiedToday(num_pages = 10) {
+    async findPagesModifiedToday(max_num_pages = 50) {
         // Define ancestor rule for traversing block hierarchy
         const ancestorRule = `[
       [ (ancestor ?b ?a)
@@ -29,7 +29,7 @@ export class PageOperations {
           (ancestor ?block ?page)
           [?block :edit/time ?time]
           [(> ?time ?start_of_day)]]
-          :limit ${num_pages}`, [startOfDay.getTime(), ancestorRule]);
+          :limit ${max_num_pages}`, [startOfDay.getTime(), ancestorRule]);
             if (!results || results.length === 0) {
                 return {
                     success: true,

package/build/tools/schemas.js

@@ -20,13 +20,13 @@ export const toolSchemas = {
     },
     roam_fetch_page_by_title: {
         name: 'roam_fetch_page_by_title',
-        description: 'Retrieve complete page contents by exact title, including all nested blocks and resolved block references. Use for reading and analyzing existing Roam pages.',
+        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: {
             type: 'object',
             properties: {
                 title: {
                     type: 'string',
-                    description: 'Title of the page to fetch and read',
+                    description: 'Title of the page. For date pages, use ordinal date formats such as January 2nd, 2025',
                 },
             },
             required: ['title'],
@@ -249,13 +249,12 @@ export const toolSchemas = {
         inputSchema: {
             type: 'object',
             properties: {
-                num_pages: {
+                max_num_pages: {
                     type: 'integer',
-                    description: 'Number of result pages to retrieve (default: 10)',
-                    default: 10
+                    description: 'Max number of pages to retrieve (default: 50)',
+                    default: 50
                 },
-            },
-            required: ['num_pages']
+            }
         }
     },
     roam_search_by_text: {
@@ -278,7 +277,7 @@ export const toolSchemas = {
     },
     roam_update_block: {
         name: 'roam_update_block',
-        description: 'Update the content of an existing block identified by its UID. Can either provide new content directly or use a transform pattern to modify existing 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).',
+        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: {
             type: 'object',
             properties: {
@@ -318,9 +317,9 @@ export const toolSchemas = {
             ]
         }
     },
-    roam_update_blocks: {
-        name: 'roam_update_blocks',
-        description: 'Update multiple blocks in a single batch operation. Each update can provide either new content directly or a transform 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).',
+    roam_update_multiple_blocks: {
+        name: 'roam_update_multiple_blocks',
+        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: {
             type: 'object',
             properties: {
@@ -372,7 +371,7 @@ export const toolSchemas = {
     },
     roam_search_by_date: {
         name: 'roam_search_by_date',
-        description: 'Search for blocks or pages based on creation or modification dates',
+        description: 'Search for blocks or pages based on creation or modification dates. Not for daily pages with ordinal date titles.',
         inputSchema: {
             type: 'object',
             properties: {

package/build/tools/tool-handlers.js

@@ -23,8 +23,8 @@ export class ToolHandlers {
         this.outlineOps = new OutlineOperations(graph);
     }
     // Page Operations
-    async findPagesModifiedToday(num_pages = 10) {
-        return this.pageOps.findPagesModifiedToday(num_pages);
+    async findPagesModifiedToday(max_num_pages = 50) {
+        return this.pageOps.findPagesModifiedToday(max_num_pages);
     }
     async createPage(title, content) {
         return this.pageOps.createPage(title, content);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roam-research-mcp",
-  "version": "0.24.2",
+  "version": "0.24.5",
   "description": "A Model Context Protocol (MCP) server for Roam Research API integration",
   "private": false,
   "repository": {