remnote-mcp-server 0.15.0 → 0.17.0

package/mcpb/remnote-local/server/fallback-tools.generated.js

@@ -3,17 +3,19 @@ export const FALLBACK_TOOLS = [
   {
     name: 'remnote_create_note',
     description:
-      'Create a new note in RemNote with optional content, parent, and exact tag Rem IDs. Supports hierarchical markdown in content and flashcard syntax (e.g. "- Term :: Definition"). At least one of title or content must be provided. Recommended preflight once per session: remnote_status.',
+      'Create a new note in RemNote with optional content, parent, and exact tag Rem IDs. Supports hierarchical markdown, flashcard syntax (e.g. "- Term :: Definition"), and exact inline Rem references as [[id:<remId>]]. At least one of title or content must be provided. Recommended preflight once per session: remnote_status.',
     inputSchema: {
       type: 'object',
       properties: {
         title: {
           type: 'string',
-          description: 'The title of the note (optional if content is provided)',
+          description:
+            'The title of the note (optional if content is provided). Supports exact Rem references as [[id:<remId>]].',
         },
         content: {
           type: 'string',
-          description: 'Content as plain text, child bullets or hierarchical markdown',
+          description:
+            'Content as plain text, child bullets, or hierarchical markdown. Use [[id:<remId>]] for exact Rem references.',
         },
         parentId: {
           type: 'string',
@@ -26,6 +28,11 @@ export const FALLBACK_TOOLS = [
           },
           description: 'Exact tag Rem IDs to apply',
         },
+        asDocument: {
+          type: 'boolean',
+          description:
+            'Mark the created title/root Rem as a document while preserving any concept/card status',
+        },
       },
       required: [],
       additionalProperties: false,
@@ -34,7 +41,7 @@ export const FALLBACK_TOOLS = [
   {
     name: 'remnote_search',
     description:
-      'Search the RemNote knowledge base. For whole-KB orientation, prefer includeContent="structured" with depth=1 and childLimit=500, then follow remIds with remnote_read_note. Use includeContent="markdown" for human-readable summaries.',
+      'Search the RemNote knowledge base. Supports cursor paging through hasMore/nextCursor. For whole-KB orientation, prefer contentMode="structured" with view="compact", depth=1, and childLimit=500. Request ancestorDepth when hierarchy context matters.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -42,16 +49,35 @@ export const FALLBACK_TOOLS = [
           type: 'string',
           description: 'Search query text',
         },
+        parentRemId: {
+          type: 'string',
+          minLength: 1,
+          description:
+            "Optional non-empty Rem ID. Scope the search to within this Rem's subtree. The Rem itself is excluded from results.",
+        },
         limit: {
           type: 'number',
           description: 'Maximum results (1-150, default: 50)',
         },
-        includeContent: {
+        cursor: {
+          type: 'string',
+          description: 'Opaque cursor returned by a previous remnote_search response',
+        },
+        contentMode: {
           type: 'string',
           enum: ['none', 'markdown', 'structured'],
           description:
             'Content rendering mode: "none" omits content (default), "markdown" renders child subtree as indented markdown, "structured" returns nested child objects with remIds',
         },
+        view: {
+          type: 'string',
+          enum: ['compact', 'standard', 'full'],
+          description: 'Output detail level: compact, standard, or full',
+        },
+        ancestorDepth: {
+          type: 'number',
+          description: 'Number of parent Rems to include, direct parent first (0-20, default: 0)',
+        },
         depth: {
           type: 'number',
           description:
@@ -72,7 +98,7 @@ export const FALLBACK_TOOLS = [
   {
     name: 'remnote_search_by_tag',
     description:
-      'Find notes by exact tag Rem ID and return resolved ancestor context targets (nearest document/daily document when available, otherwise nearest non-document ancestor). Does not look up tags by name or alias. Supports the same includeContent modes as remnote_search.',
+      'Find notes by exact tag Rem ID. Supports cursor paging through hasMore/nextCursor. Default resultMode="context" returns resolved ancestor context targets with matchedRems; resultMode="tagged" returns directly tagged Rems with context metadata. Request ancestorDepth to include parent-first ancestors on both context results and matchedRems.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -80,16 +106,31 @@ export const FALLBACK_TOOLS = [
           type: 'string',
           description: 'Exact tag Rem ID to search',
         },
+        resultMode: {
+          type: 'string',
+          enum: ['context', 'tagged'],
+          description:
+            '"context" returns resolved ancestor context targets with matchedRems (default); "tagged" returns directly tagged Rems with context metadata',
+        },
         limit: {
           type: 'number',
           description: 'Maximum results (1-150, default: 50)',
         },
-        includeContent: {
+        contentMode: {
           type: 'string',
           enum: ['none', 'markdown', 'structured'],
           description:
             'Content rendering mode: "none" omits content (default), "markdown" renders child subtree as indented markdown, "structured" returns nested child objects with remIds',
         },
+        view: {
+          type: 'string',
+          enum: ['compact', 'standard', 'full'],
+          description: 'Output detail level: compact, standard, or full',
+        },
+        ancestorDepth: {
+          type: 'number',
+          description: 'Number of parent Rems to include, direct parent first (0-20, default: 0)',
+        },
         depth: {
           type: 'number',
           description:
@@ -103,6 +144,15 @@ export const FALLBACK_TOOLS = [
           type: 'number',
           description: 'Maximum character length for rendered content (default: 3000)',
         },
+        cursor: {
+          type: 'string',
+          description: 'Opaque cursor returned by a previous remnote_search_by_tag response',
+        },
+        timeoutMs: {
+          type: 'number',
+          description:
+            'Per-call bridge wait timeout in milliseconds (1-60000, default: 15000). Does not cancel plugin-side work.',
+        },
       },
       required: ['tagRemId'],
     },
@@ -110,7 +160,7 @@ export const FALLBACK_TOOLS = [
   {
     name: 'remnote_read_note',
     description:
-      'Read a specific note from RemNote by its Rem ID. For hierarchy traversal, prefer includeContent="structured" and start shallow (depth=1, childLimit=500), then deepen only selected branches. Use includeContent="markdown" for summarization.',
+      'Read a specific note from RemNote by its Rem ID. For hierarchy traversal, prefer contentMode="structured" and start shallow (depth=1, childLimit=500), then deepen only selected branches. Request ancestorDepth when placement context matters.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -122,12 +172,21 @@ export const FALLBACK_TOOLS = [
           type: 'number',
           description: 'Depth of child hierarchy to render (0-10, default: 5)',
         },
-        includeContent: {
+        contentMode: {
           type: 'string',
           enum: ['none', 'markdown', 'structured'],
           description:
             'Content rendering mode: "markdown" renders child subtree (default), "structured" returns nested child objects with remIds, "none" omits content',
         },
+        view: {
+          type: 'string',
+          enum: ['compact', 'standard', 'full'],
+          description: 'Output detail level: compact, standard, or full',
+        },
+        ancestorDepth: {
+          type: 'number',
+          description: 'Number of parent Rems to include, direct parent first (0-20, default: 0)',
+        },
         childLimit: {
           type: 'number',
           description: 'Maximum children per level (1-500, default: 100)',
@@ -136,13 +195,80 @@ export const FALLBACK_TOOLS = [
           type: 'number',
           description: 'Maximum character length for rendered content (default: 100000)',
         },
+        includeMediaMetadata: {
+          type: 'boolean',
+          description:
+            'Include ordered image metadata from the root Rem text and backText fields (default: false)',
+        },
       },
       required: ['remId'],
     },
   },
+  {
+    name: 'remnote_get_media',
+    description:
+      'Retrieve a RemNote-managed local image as MCP-native image content. First call remnote_read_note with includeMediaMetadata=true, then pass the returned remId, field, and mediaId. Requires bridge capability media.images.v1. External URL retrieval is not supported.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        remId: {
+          type: 'string',
+          description: 'Root Rem ID containing the image',
+        },
+        field: {
+          type: 'string',
+          enum: ['text', 'backText'],
+          description: 'Rich-text field containing the image',
+        },
+        mediaId: {
+          type: 'string',
+          description: 'Stable media ID returned by remnote_read_note',
+        },
+        maxInlineBytes: {
+          type: 'number',
+          description: 'Maximum bytes to inline (default 5 MiB, hard maximum 10 MiB)',
+        },
+      },
+      required: ['remId', 'field', 'mediaId'],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: 'remnote_list_children',
+    description:
+      'List direct child Rems under a parent without rendering a subtree. Use for cheap hierarchy traversal; page with nextCursor when hasMore is true.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        parentRemId: {
+          type: 'string',
+          description: 'Parent Rem ID whose direct children to list',
+        },
+        limit: {
+          type: 'number',
+          description: 'Maximum direct children (1-150, default: 50)',
+        },
+        cursor: {
+          type: 'string',
+          description: 'Opaque cursor returned by a previous remnote_list_children response',
+        },
+        view: {
+          type: 'string',
+          enum: ['compact', 'standard', 'full'],
+          description: 'Output detail level for child metadata: compact, standard, or full',
+        },
+        ancestorDepth: {
+          type: 'number',
+          description: 'Number of parent Rems to include for each child, direct parent first',
+        },
+      },
+      required: ['parentRemId'],
+    },
+  },
   {
     name: 'remnote_update_note',
-    description: 'Update note metadata in RemNote. Use this tool for title changes only.',
+    description:
+      'Update note metadata in RemNote. Use this tool for title changes only. The title supports exact Rem references as [[id:<remId>]].',
     inputSchema: {
       type: 'object',
       properties: {
@@ -152,13 +278,84 @@ export const FALLBACK_TOOLS = [
         },
         title: {
           type: 'string',
-          description: 'New title',
+          description: 'New title. Use [[id:<remId>]] for exact Rem references.',
         },
       },
       required: ['remId', 'title'],
       additionalProperties: false,
     },
   },
+  {
+    name: 'remnote_set_document_status',
+    description:
+      'Preview or set whether an existing Rem is marked as a document. Uses dryRun=true by default, preserves Rem ID, children, parent, tags, and concept/card status, and requires write operations to be enabled.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        remId: {
+          type: 'string',
+          description: 'The Rem ID whose document status should change',
+        },
+        isDocument: {
+          type: 'boolean',
+          description: 'Whether the Rem should be marked as a document',
+        },
+        dryRun: {
+          type: 'boolean',
+          description:
+            'Preview the document-status change without mutating RemNote (default: true)',
+        },
+        expectedOldRemType: {
+          type: 'string',
+          enum: ['document', 'dailyDocument', 'concept', 'descriptor', 'portal', 'text'],
+          description:
+            'Optional stale-context guard; reject if current remType differs from this value',
+        },
+      },
+      required: ['remId', 'isDocument'],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: 'remnote_move_note',
+    description:
+      'Safely move an existing Rem and its subtree under a new parent. Defaults to dryRun=true; pass dryRun=false only after user approval. expectedOldParentRemId rejects stale move proposals.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        remId: {
+          type: 'string',
+          description: 'Rem ID to move',
+        },
+        newParentRemId: {
+          type: 'string',
+          description: 'New parent Rem ID',
+        },
+        position: {
+          type: 'string',
+          enum: ['first', 'last', 'before', 'after'],
+          description: 'Where to place the moved Rem under the new parent (default: last)',
+        },
+        siblingRemId: {
+          type: 'string',
+          description: 'Sibling Rem ID required for before/after positioning',
+        },
+        dryRun: {
+          type: 'boolean',
+          description: 'Preview without mutating RemNote (default: true)',
+        },
+        expectedOldParentRemId: {
+          type: 'string',
+          description: 'Reject if the current direct parent differs from this Rem ID',
+        },
+        ancestorDepth: {
+          type: 'number',
+          description: 'Number of parent Rems to include before/after the move',
+        },
+      },
+      required: ['remId', 'newParentRemId'],
+    },
+  },
   {
     name: 'remnote_insert_children',
     description:
@@ -172,7 +369,8 @@ export const FALLBACK_TOOLS = [
         },
         content: {
           type: 'string',
-          description: 'Markdown content to insert as child Rems',
+          description:
+            'Markdown content to insert as child Rems. Use [[id:<remId>]] for exact Rem references.',
         },
         position: {
           type: 'string',
@@ -202,7 +400,7 @@ export const FALLBACK_TOOLS = [
         content: {
           type: 'string',
           description:
-            'Markdown content to use as replacement children; empty string clears all direct children',
+            'Markdown content to use as replacement children; empty string clears all direct children. Use [[id:<remId>]] for exact Rem references.',
         },
       },
       required: ['parentRemId', 'content'],
@@ -241,6 +439,78 @@ export const FALLBACK_TOOLS = [
       additionalProperties: false,
     },
   },
+  {
+    name: 'remnote_set_property',
+    description:
+      'Set or clear a tag/table property value on a Rem by exact IDs. The bridge verifies the property belongs to the supplied tag/table Rem, adds the tag idempotently, then writes the property value. For select properties, pass the option Rem ID as value.kind="rem_reference".',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        remId: {
+          type: 'string',
+          description: 'The Rem ID whose tag property should be set',
+        },
+        tagRemId: {
+          type: 'string',
+          description: 'Exact tag/table Rem ID that owns the property',
+        },
+        propertyRemId: {
+          type: 'string',
+          description: 'Exact property Rem ID under the tag/table Rem',
+        },
+        value: {
+          oneOf: [
+            {
+              type: 'object',
+              properties: {
+                kind: {
+                  type: 'string',
+                  const: 'text',
+                },
+                text: {
+                  type: 'string',
+                  description:
+                    'Plain text or markdown property value. Use [[id:<remId>]] for exact Rem references.',
+                },
+              },
+              required: ['kind', 'text'],
+              additionalProperties: false,
+            },
+            {
+              type: 'object',
+              properties: {
+                kind: {
+                  type: 'string',
+                  const: 'rem_reference',
+                },
+                remId: {
+                  type: 'string',
+                  description: 'Referenced Rem ID; use select-option Rem IDs here too',
+                },
+              },
+              required: ['kind', 'remId'],
+              additionalProperties: false,
+            },
+            {
+              type: 'object',
+              properties: {
+                kind: {
+                  type: 'string',
+                  const: 'clear',
+                },
+              },
+              required: ['kind'],
+              additionalProperties: false,
+            },
+          ],
+          description:
+            'Property value. Use text for plain values, rem_reference for Rem references and select options, or clear to remove the value.',
+        },
+      },
+      required: ['remId', 'tagRemId', 'propertyRemId', 'value'],
+      additionalProperties: false,
+    },
+  },
   {
     name: 'remnote_append_journal',
     description:
@@ -250,7 +520,8 @@ export const FALLBACK_TOOLS = [
       properties: {
         content: {
           type: 'string',
-          description: "Content to append to today's daily document (markdown supported)",
+          description:
+            "Content to append to today's daily document (markdown supported). Use [[id:<remId>]] for exact Rem references.",
         },
         timestamp: {
           type: 'boolean',

package/mcpb/remnote-local/server/index.js

@@ -19,11 +19,13 @@ const packageJson = require('../package.json');
 export const SERVER_INFO = { name: 'remnote-mcp-stdio', version: packageJson.version };
 
 export function normalizeMcpUrl(value) {
-  const trimmed = String(value || DEFAULT_MCP_URL).trim();
+  const trimmed = String(value || DEFAULT_MCP_URL)
+    .trim()
+    .replace(/\/+$/, '');
   if (trimmed.endsWith('/mcp')) {
     return trimmed;
   }
-  return `${trimmed.replace(/\/+$/, '')}/mcp`;
+  return `${trimmed}/mcp`;
 }
 
 export function createSdkHttpClient(mcpUrl, clientInfo = SERVER_INFO) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remnote-mcp-server",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "MCP server bridge for RemNote knowledge base",
   "type": "module",
   "main": "dist/index.js",
@@ -63,7 +63,7 @@
   "homepage": "https://github.com/robert7/remnote-mcp-server#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "commander": "^14.0.3",
+    "commander": "^15.0.0",
     "express": "^5.2.0",
     "pino": "^10.3.1",
     "ws": "^8.20.0",
@@ -72,7 +72,7 @@
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/express": "^5.0.0",
-    "@types/node": "^25.5.2",
+    "@types/node": "^26.1.1",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.58.1",
     "@typescript-eslint/parser": "^8.58.1",
@@ -87,6 +87,6 @@
     "vitest": "^4.1.3"
   },
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=22.13.0"
   }
 }