roam-research-mcp 1.6.0 → 2.4.3

package/build/tools/schemas.js

@@ -1,11 +1,34 @@
 // Tool definitions and input schemas for Roam Research MCP server
+/**
+ * Multi-graph parameters that are added to all tool schemas
+ * These enable targeting specific graphs and providing write confirmation
+ */
+const multiGraphParams = {
+    graph: {
+        type: 'string',
+        description: 'Target graph key from ROAM_GRAPHS config. Defaults to ROAM_DEFAULT_GRAPH. Only needed in multi-graph mode.'
+    },
+    write_key: {
+        type: 'string',
+        description: 'Write confirmation key. Required for write operations on non-default graphs when write_key is configured.'
+    }
+};
+/**
+ * Helper to add multi-graph params to a schema's properties
+ */
+function withMultiGraphParams(properties) {
+    return {
+        ...properties,
+        ...multiGraphParams
+    };
+}
 export const toolSchemas = {
     roam_add_todo: {
         name: 'roam_add_todo',
         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).\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 todos: {
                     type: 'array',
                     items: {
@@ -14,7 +37,7 @@ export const toolSchemas = {
                     },
                     description: 'List of todo items to add'
                 }
-            },
+            }),
             required: ['todos'],
         },
     },
@@ -23,7 +46,7 @@ export const toolSchemas = {
         description: 'Fetch page by title. Returns content in the specified format.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 title: {
                     type: 'string',
                     description: 'Title of the page. For date pages, use ordinal date formats such as January 2nd, 2025'
@@ -34,7 +57,7 @@ export const toolSchemas = {
                     default: 'raw',
                     description: "Format output as markdown or JSON. 'markdown' returns as string; 'raw' returns JSON string of the page's blocks"
                 }
-            },
+            }),
             required: ['title']
         },
     },
@@ -43,7 +66,7 @@ export const toolSchemas = {
         description: 'Create a new standalone page in Roam with optional content, including structured outlines and tables, using explicit nesting levels and headings (H1-H3). This is the preferred method for creating a new page with an outline in a single step. Best for:\n- Creating foundational concept pages that other pages will link to/from\n- Establishing new topic areas that need their own namespace\n- Setting up reference materials or documentation\n- Making permanent collections of information\n- Creating pages with mixed text and table content in one call.\n**Efficiency Tip:** This tool batches page and content creation efficiently. For adding content to existing pages, use `roam_process_batch_actions` instead.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 title: {
                     type: 'string',
                     description: 'Title of the new page',
@@ -104,7 +127,7 @@ export const toolSchemas = {
                         required: ['level']
                     }
                 },
-            },
+            }),
             required: ['title'],
         },
     },
@@ -113,7 +136,7 @@ export const toolSchemas = {
         description: 'Add a structured outline to an existing page or block (by title text or uid), with customizable nesting levels. To create a new page with an outline, use the `roam_create_page` tool instead. The `outline` parameter defines *new* blocks to be created. To nest content under an *existing* block, provide its UID or exact text in `block_text_uid`, and ensure the `outline` array contains only the child blocks with levels relative to that parent. Including the parent block\'s text in the `outline` array will create a duplicate block. Best for:\n- Adding supplementary structured content to existing pages\n- Creating temporary or working outlines (meeting notes, brainstorms)\n- Organizing thoughts or research under a specific topic\n- Breaking down subtopics or components of a larger concept\nBest for simpler, contiguous hierarchical content. For complex nesting (e.g., tables) or granular control over block placement, consider `roam_process_batch_actions` instead.\n**API Usage Note:** This tool performs verification queries after creation. For large outlines (10+ items) or when rate limits are a concern, consider using `roam_process_batch_actions` instead to minimize API calls.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 page_title_uid: {
                     type: 'string',
                     description: 'Title or UID of the page (UID is preferred for accuracy). Leave blank to use the default daily page.'
@@ -153,7 +176,7 @@ export const toolSchemas = {
                         required: ['text', 'level']
                     }
                 }
-            },
+            }),
             required: ['outline']
         }
     },
@@ -162,7 +185,7 @@ export const toolSchemas = {
         description: 'Import nested markdown content into Roam under a specific block. Can locate the parent block by UID (preferred) or by exact string match within a specific page. If a `parent_string` is provided and the block does not exist, it will be created. Returns a nested structure of the created blocks.\n**API Usage Note:** This tool fetches the full nested structure after import for verification. For large imports or when rate limits are a concern, consider using `roam_process_batch_actions` with pre-structured actions instead.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 content: {
                     type: 'string',
                     description: 'Nested markdown content to import'
@@ -189,7 +212,7 @@ export const toolSchemas = {
                     enum: ['first', 'last'],
                     default: 'first'
                 }
-            },
+            }),
             required: ['content']
         }
     },
@@ -198,7 +221,7 @@ export const toolSchemas = {
         description: 'Search for blocks containing a specific tag and optionally filter by blocks that also contain another tag nearby or exclude blocks with a specific tag. This tool supports pagination via the `limit` and `offset` parameters. Use this tool to search for memories tagged with the MEMORIES_TAG.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 primary_tag: {
                     type: 'string',
                     description: 'The main tag to search for (without the [[ ]] brackets)',
@@ -226,7 +249,7 @@ export const toolSchemas = {
                     description: 'Optional: The number of results to skip before returning matches. Useful for pagination. Defaults to 0.',
                     default: 0
                 }
-            },
+            }),
             required: ['primary_tag']
         }
     },
@@ -235,7 +258,7 @@ export const toolSchemas = {
         description: 'Search for blocks with a specific status (TODO/DONE) across all pages or within a specific page.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 status: {
                     type: 'string',
                     description: 'Status to search for (TODO or DONE)',
@@ -253,7 +276,7 @@ export const toolSchemas = {
                     type: 'string',
                     description: 'Optional: Comma-separated list of terms to filter results by exclusion (matches content or page title)'
                 }
-            },
+            }),
             required: ['status']
         }
     },
@@ -262,7 +285,7 @@ export const toolSchemas = {
         description: 'Search for block references within a page or across the entire graph. Can search for references to a specific block, a page title, or find all block references.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 block_uid: {
                     type: 'string',
                     description: 'Optional: UID of the block to find references to (searches for ((uid)) patterns in text)'
@@ -275,7 +298,7 @@ export const toolSchemas = {
                     type: 'string',
                     description: 'Optional: Title or UID of the page to search in (UID is preferred for accuracy). If not provided, searches across all pages.'
                 }
-            }
+            })
         }
     },
     roam_search_hierarchy: {
@@ -283,7 +306,7 @@ export const toolSchemas = {
         description: 'Search for parent or child blocks in the block hierarchy. Can search up or down the hierarchy from a given block.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 parent_uid: {
                     type: 'string',
                     description: 'Optional: UID of the block to find children of'
@@ -302,7 +325,7 @@ export const toolSchemas = {
                     minimum: 1,
                     maximum: 10
                 }
-            }
+            })
             // Note: Validation for either parent_uid or child_uid is handled in the server code
         }
     },
@@ -311,7 +334,7 @@ export const toolSchemas = {
         description: 'Find pages that have been modified today (since midnight), with pagination and sorting options.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 limit: {
                     type: 'integer',
                     description: 'The maximum number of pages to retrieve (default: 50). Use -1 for no limit, but be aware that very large result sets can impact performance.',
@@ -328,7 +351,7 @@ export const toolSchemas = {
                     enum: ['asc', 'desc'],
                     default: 'desc'
                 }
-            }
+            })
         }
     },
     roam_search_by_text: {
@@ -336,7 +359,7 @@ export const toolSchemas = {
         description: 'Search for blocks containing specific text across all pages or within a specific page. This tool supports pagination via the `limit` and `offset` parameters.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 text: {
                     type: 'string',
                     description: 'The text to search for'
@@ -360,7 +383,7 @@ export const toolSchemas = {
                     description: 'Optional: The number of results to skip before returning matches. Useful for pagination. Defaults to 0.',
                     default: 0
                 }
-            },
+            }),
             required: ['text']
         }
     },
@@ -369,7 +392,7 @@ export const toolSchemas = {
         description: 'Search for blocks or pages based on creation or modification dates. Not for daily pages with ordinal date titles.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 start_date: {
                     type: 'string',
                     description: 'Start date in ISO format (YYYY-MM-DD)',
@@ -393,7 +416,7 @@ export const toolSchemas = {
                     description: 'Whether to include the content of matching blocks/pages',
                     default: true,
                 }
-            },
+            }),
             required: ['start_date', 'type', 'scope']
         }
     },
@@ -402,28 +425,41 @@ export const toolSchemas = {
         description: 'Provides the content of the Roam Markdown Cheatsheet resource, optionally concatenated with custom instructions if CUSTOM_INSTRUCTIONS_PATH is set.',
         inputSchema: {
             type: 'object',
-            properties: {},
+            properties: withMultiGraphParams({}),
             required: [],
         },
     },
     roam_remember: {
         name: 'roam_remember',
-        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).\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
+        description: 'Add a memory or piece of information to remember, stored on the daily page with MEMORIES_TAG tag and optional categories (unless include_memories_tag is false). \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).\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 memory: {
                     type: 'string',
-                    description: 'The memory detail or information to remember'
+                    description: 'The memory detail or information to remember. Add tags in `categories`.'
                 },
                 categories: {
                     type: 'array',
                     items: {
                         type: 'string'
                     },
-                    description: 'Optional categories to tag the memory with (will be converted to Roam tags)'
+                    description: 'Optional categories to tag the memory with (will be converted to Roam tags). Do not duplicate tags added in `memory` parameter.'
+                },
+                heading: {
+                    type: 'string',
+                    description: 'Optional heading text to nest the memory under (e.g., "Memories" or "## LLM Memories"). If the heading does not exist on the daily page, it will be created. Ignored if parent_uid is provided.'
+                },
+                parent_uid: {
+                    type: 'string',
+                    description: 'Optional UID of a specific block to nest the memory under. Takes precedence over heading parameter.'
+                },
+                include_memories_tag: {
+                    type: 'boolean',
+                    description: 'Whether to append the MEMORIES_TAG tag to the memory block.',
+                    default: true
                 }
-            },
+            }),
             required: ['memory']
         }
     },
@@ -432,7 +468,7 @@ export const toolSchemas = {
         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 specific tag and sort by creation date.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 sort_by: {
                     type: 'string',
                     description: 'Sort order for memories based on creation date',
@@ -443,7 +479,7 @@ export const toolSchemas = {
                     type: 'string',
                     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)'
                 }
-            }
+            })
         }
     },
     roam_datomic_query: {
@@ -451,7 +487,7 @@ export const toolSchemas = {
         description: 'Execute a custom Datomic query on the Roam graph for advanced data retrieval beyond the available search tools. This provides direct access to Roam\'s query engine. Note: Roam graph is case-sensitive.\n\n__Optimal Use Cases for `roam_datomic_query`:__\n- __Advanced Filtering (including Regex):__ Use for scenarios requiring complex filtering, including regex matching on results post-query, which Datalog does not natively support for all data types. It can fetch broader results for client-side post-processing.\n- __Highly Complex Boolean Logic:__ Ideal for intricate combinations of "AND", "OR", and "NOT" conditions across multiple terms or attributes.\n- __Arbitrary Sorting Criteria:__ The go-to for highly customized sorting needs beyond default options.\n- __Proximity Search:__ For advanced search capabilities involving proximity, which are difficult to implement efficiently with simpler tools.\n\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: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 query: {
                     type: 'string',
                     description: 'The Datomic query to execute (in Datalog syntax). Example: `[:find ?block-string :where [?block :block/string ?block-string] (or [(clojure.string/includes? ?block-string "hypnosis")] [(clojure.string/includes? ?block-string "trance")] [(clojure.string/includes? ?block-string "suggestion")]) :limit 25]`'
@@ -478,7 +514,7 @@ export const toolSchemas = {
                     },
                     description: 'Optional: An array of field paths (e.g., ["block_string", "page_title"]) within each Datomic result object to apply the regex filter to. If not provided, the regex is applied to the stringified full result.'
                 }
-            },
+            }),
             required: ['query']
         }
     },
@@ -487,7 +523,7 @@ export const toolSchemas = {
         description: '**RATE LIMIT EFFICIENT:** This is the most API-efficient tool for multiple block operations. Combine all create/update/delete operations into a single call whenever possible. For intensive page updates or revisions, prefer this tool over multiple sequential calls.\n\nExecutes a sequence of low-level block actions (create, update, move, delete) in a single, non-transactional batch. Actions are executed in the provided order.\n\n**UID Placeholders for Nested Blocks:** Use `{{uid:name}}` syntax for parent-child references within the same batch. The server generates proper random UIDs and returns a `uid_map` showing placeholder→UID mappings. Example: `{ uid: "{{uid:parent1}}", string: "Parent" }` then `{ location: { "parent-uid": "{{uid:parent1}}" }, string: "Child" }`. Response includes `{ success: true, uid_map: { "parent1": "Xk7mN2pQ9" } }`.\n\nFor actions on existing blocks, a valid block UID is required. Note: Roam-flavored markdown, including block embedding with `((UID))` syntax, is supported within the `string` property for `create-block` and `update-block` actions. For actions on existing blocks or within a specific page context, it is often necessary to first obtain valid page or block UIDs. Tools like `roam_fetch_page_by_title` or other search tools can be used to retrieve these UIDs before executing batch actions. For simpler, sequential outlines, `roam_create_outline` is often more suitable.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 actions: {
                     type: 'array',
                     description: 'An array of action objects to execute in order.',
@@ -544,7 +580,7 @@ export const toolSchemas = {
                         required: ['action']
                     }
                 }
-            },
+            }),
             required: ['actions']
         }
     },
@@ -553,7 +589,7 @@ export const toolSchemas = {
         description: 'Fetch a block by its UID along with its hierarchical children down to a specified depth. Returns a nested object structure containing the block\'s UID, text, order, and an array of its children.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 block_uid: {
                     type: 'string',
                     description: 'The UID of the block to fetch.'
@@ -564,7 +600,7 @@ export const toolSchemas = {
                     minimum: 0,
                     maximum: 10
                 }
-            },
+            }),
             required: ['block_uid']
         },
     },
@@ -573,7 +609,7 @@ export const toolSchemas = {
         description: 'Create a table in Roam with specified headers and rows. This tool abstracts the complex nested structure that Roam tables require, making it much easier to create properly formatted tables.\n\n**Why use this tool:**\n- Roam tables require precise nested block structures that are error-prone to create manually\n- Automatically handles the {{[[table]]}} container and nested column structure\n- Validates row/column consistency before execution\n- Converts empty cells to spaces (required by Roam)\n\n**Example:** A table with headers ["", "Column A", "Column B"] and rows [{label: "Row 1", cells: ["A1", "B1"]}] creates a 2x3 table.\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 parent_uid: {
                     type: 'string',
                     description: 'The UID of the parent block or page where the table should be created.'
@@ -612,16 +648,39 @@ export const toolSchemas = {
                         required: ['label', 'cells']
                     }
                 }
-            },
+            }),
             required: ['parent_uid', 'headers', 'rows']
         }
     },
+    roam_move_block: {
+        name: 'roam_move_block',
+        description: 'Move a block to a new location (different parent or position). This is a convenience wrapper around `roam_process_batch_actions` for single block moves.',
+        inputSchema: {
+            type: 'object',
+            properties: withMultiGraphParams({
+                block_uid: {
+                    type: 'string',
+                    description: 'The UID of the block to move'
+                },
+                parent_uid: {
+                    type: 'string',
+                    description: 'The UID of the new parent block or page'
+                },
+                order: {
+                    type: ['integer', 'string'],
+                    description: 'Position under the new parent. Can be a number (0-based index) or "first"/"last". Defaults to "last".',
+                    default: 'last'
+                }
+            }),
+            required: ['block_uid', 'parent_uid']
+        }
+    },
     roam_update_page_markdown: {
         name: 'roam_update_page_markdown',
         description: 'Update an existing page with new markdown content using smart diff. Preserves block UIDs where possible and generates minimal changes. This is ideal for:\n- Syncing external markdown files to Roam\n- AI-assisted content updates that preserve references\n- Batch content modifications without losing block references\n\n**How it works:**\n1. Fetches existing page blocks\n2. Matches new content to existing blocks by text similarity\n3. Generates minimal create/update/move/delete operations\n4. Preserves UIDs for matched blocks (keeping references intact)\n\nIMPORTANT: Before using this tool, ensure that you have loaded into context the \'Roam Markdown Cheatsheet\' resource.',
         inputSchema: {
             type: 'object',
-            properties: {
+            properties: withMultiGraphParams({
                 title: {
                     type: 'string',
                     description: 'Title of the page to update'
@@ -635,8 +694,30 @@ export const toolSchemas = {
                     description: 'If true, returns the planned actions without executing them. Useful for previewing changes.',
                     default: false
                 }
-            },
+            }),
             required: ['title', 'markdown']
         }
     },
+    roam_rename_page: {
+        name: 'roam_rename_page',
+        description: 'Rename a page by changing its title. Identifies the page by current title or UID.',
+        inputSchema: {
+            type: 'object',
+            properties: withMultiGraphParams({
+                old_title: {
+                    type: 'string',
+                    description: 'Current title of the page to rename (use this OR uid, not both)'
+                },
+                uid: {
+                    type: 'string',
+                    description: 'UID of the page to rename (use this OR old_title, not both)'
+                },
+                new_title: {
+                    type: 'string',
+                    description: 'New title for the page'
+                }
+            }),
+            required: ['new_title']
+        }
+    },
 };

package/build/tools/tool-handlers.js

@@ -39,6 +39,9 @@ export class ToolHandlers {
     async fetchBlockWithChildren(block_uid, depth) {
         return this.blockRetrievalOps.fetchBlockWithChildren(block_uid, depth);
     }
+    async moveBlock(block_uid, parent_uid, order = 'last') {
+        return this.blockOps.moveBlock(block_uid, parent_uid, order);
+    }
     // Search Operations
     async searchByStatus(status, page_title_uid, include, exclude) {
         return this.searchOps.searchByStatus(status, page_title_uid, include, exclude);
@@ -64,8 +67,8 @@ export class ToolHandlers {
         return handler.execute();
     }
     // Memory Operations
-    async remember(memory, categories) {
-        return this.memoryOps.remember(memory, categories);
+    async remember(memory, categories, heading, parent_uid, include_memories_tag) {
+        return this.memoryOps.remember(memory, categories, heading, parent_uid, include_memories_tag);
     }
     async recall(sort_by = 'newest', filter_tag) {
         return this.memoryOps.recall(sort_by, filter_tag);
@@ -93,6 +96,10 @@ export class ToolHandlers {
     async updatePageMarkdown(title, markdown, dryRun = false) {
         return this.pageOps.updatePageMarkdown(title, markdown, dryRun);
     }
+    // Page Rename
+    async renamePage(params) {
+        return this.pageOps.renamePage(params);
+    }
     async getRoamMarkdownCheatsheet() {
         if (this.cachedCheatsheet) {
             return this.cachedCheatsheet;

package/build/utils/helpers.js

@@ -17,3 +17,25 @@ export function formatRoamDate(date) {
     const year = date.getFullYear();
     return `${month} ${day}${getOrdinalSuffix(day)}, ${year}`;
 }
+/**
+ * Resolve relative date keywords to Roam date format.
+ * Returns the original string if not a recognized keyword.
+ */
+export function resolveRelativeDate(input) {
+    const lower = input.toLowerCase().trim();
+    const today = new Date();
+    switch (lower) {
+        case 'today':
+            return formatRoamDate(today);
+        case 'yesterday':
+            const yesterday = new Date(today);
+            yesterday.setDate(today.getDate() - 1);
+            return formatRoamDate(yesterday);
+        case 'tomorrow':
+            const tomorrow = new Date(today);
+            tomorrow.setDate(today.getDate() + 1);
+            return formatRoamDate(tomorrow);
+        default:
+            return input;
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "roam-research-mcp",
-  "version": "1.6.0",
-  "description": "A Model Context Protocol (MCP) server for Roam Research API integration",
+  "version": "2.4.3",
+  "description": "MCP server and CLI for Roam Research",
   "private": false,
   "repository": {
     "type": "git",
@@ -35,9 +35,11 @@
     "inspector": "npx @modelcontextprotocol/inspector build/index.js",
     "start": "node build/index.js",
     "prepublishOnly": "npm run clean && npm run build",
-    "release:patch": "npm version patch && git push origin v$(node -p \"require('./package.json').version\")",
-    "release:minor": "npm version minor && git push origin v$(node -p \"require('./package.json').version\")",
-    "release:major": "npm version major && git push origin v$(node -p \"require('./package.json').version\")",
+    "release": "standard-version",
+    "release:patch": "standard-version --release-as patch",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
+    "release:first": "standard-version --first-release",
     "test": "vitest run",
     "test:watch": "vitest"
   },
@@ -49,6 +51,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.11.24",
+    "standard-version": "^9.5.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.3.3",
     "vitest": "^3.2.4"