bear-notes-mcp 2.7.0 → 2.8.1

package/README.md

@@ -26,6 +26,8 @@ Search, read, create, and update your Bear Notes from any AI assistant.
 - **`bear-find-untagged-notes`** - Find notes in your Bear library that have no tags assigned
 - **`bear-add-tag`** - Add one or more tags to an existing Bear note
 - **`bear-archive-note`** - Archive a Bear note to remove it from active lists without deleting it
+- **`bear-rename-tag`** - Rename a tag across all notes in your Bear library
+- **`bear-delete-tag`** - Delete a tag from all notes in your Bear library without affecting the notes
 <!-- TOOLS:END -->
 
 **Requirements**: Node.js 24.13.0+

package/dist/bear-urls.js

@@ -17,7 +17,17 @@ export function buildBearUrl(action, params = {}) {
     const baseUrl = `${BEAR_URL_SCHEME}${action.trim()}`;
     const urlParams = new URLSearchParams();
     // Add provided parameters with proper encoding
-    const stringParams = ['title', 'text', 'tags', 'id', 'header', 'file', 'filename'];
+    const stringParams = [
+        'title',
+        'text',
+        'tags',
+        'id',
+        'header',
+        'file',
+        'filename',
+        'name',
+        'new_name',
+    ];
     for (const key of stringParams) {
         const value = params[key];
         if (value !== undefined && value.trim()) {

package/dist/config.js

@@ -1,4 +1,4 @@
-export const APP_VERSION = '2.7.0';
+export const APP_VERSION = '2.8.1';
 export const BEAR_URL_SCHEME = 'bear://x-callback-url/';
 export const CORE_DATA_EPOCH_OFFSET = 978307200; // 2001-01-01 to Unix epoch
 export const DEFAULT_SEARCH_LIMIT = 50;

package/dist/main.js

@@ -52,11 +52,27 @@ Use bear-search-notes to find the correct note identifier.`);
             `ID: ${noteWithContent.identifier}`,
         ];
         const noteText = noteWithContent.text || '*This note appears to be empty.*';
-        return createToolResponse(`${noteInfo.join('\n')}
-
----
-
-${noteText}`);
+        const annotations = { audience: ['user', 'assistant'] };
+        // Body and file metadata are separate content blocks so the synthetic
+        // file section can never leak back during write operations (#86)
+        const content = [
+            {
+                type: 'text',
+                text: `${noteInfo.join('\n')}\n\n---\n\n${noteText}`,
+                annotations,
+            },
+        ];
+        if (noteWithContent.files?.length) {
+            const fileEntries = noteWithContent.files
+                .map((f) => `## ${f.filename}\n\n${f.content}`)
+                .join('\n\n---\n\n');
+            content.push({
+                type: 'text',
+                text: `# Attached Files\n\n${fileEntries}`,
+                annotations,
+            });
+        }
+        return { content };
     }
     catch (error) {
         logger.error('bear-open-note failed:', error);
@@ -546,6 +562,90 @@ The note has been moved to Bear's archive.`);
         throw error;
     }
 });
+server.registerTool('bear-rename-tag', {
+    title: 'Rename Tag',
+    description: 'Rename a tag across all notes in your Bear library. Useful for reorganizing tag taxonomy, fixing typos, or restructuring tag hierarchies. Use bear-list-tags first to see existing tags.',
+    inputSchema: {
+        name: z
+            .string()
+            .trim()
+            .transform((v) => v.replace(/^#/, ''))
+            .pipe(z.string().min(1, 'Tag name is required'))
+            .describe('Current tag name to rename (without # symbol)'),
+        new_name: z
+            .string()
+            .trim()
+            .transform((v) => v.replace(/^#/, ''))
+            .pipe(z.string().min(1, 'New tag name is required'))
+            .describe('New tag name (without # symbol). Use slashes for hierarchy, e.g., "archive/old-project"'),
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+}, async ({ name, new_name }) => {
+    logger.info(`bear-rename-tag called with name: "${name}", new_name: "${new_name}"`);
+    try {
+        const url = buildBearUrl('rename-tag', {
+            name,
+            new_name,
+            open_note: 'no',
+            new_window: 'no',
+            show_window: 'no',
+        });
+        await executeBearXCallbackApi(url);
+        return createToolResponse(`Tag renamed successfully!
+
+From: #${name}
+To: #${new_name}
+
+The tag has been renamed across all notes in your Bear library.`);
+    }
+    catch (error) {
+        logger.error('bear-rename-tag failed:', error);
+        throw error;
+    }
+});
+server.registerTool('bear-delete-tag', {
+    title: 'Delete Tag',
+    description: 'Delete a tag from all notes in your Bear library. Removes the tag but preserves the notes themselves. Use bear-list-tags first to see existing tags.',
+    inputSchema: {
+        name: z
+            .string()
+            .trim()
+            .transform((v) => v.replace(/^#/, ''))
+            .pipe(z.string().min(1, 'Tag name is required'))
+            .describe('Tag name to delete (without # symbol)'),
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+}, async ({ name }) => {
+    logger.info(`bear-delete-tag called with name: "${name}"`);
+    try {
+        const url = buildBearUrl('delete-tag', {
+            name,
+            open_note: 'no',
+            new_window: 'no',
+            show_window: 'no',
+        });
+        await executeBearXCallbackApi(url);
+        return createToolResponse(`Tag deleted successfully!
+
+Tag: #${name}
+
+The tag has been removed from all notes. The notes themselves are not affected.`);
+    }
+    catch (error) {
+        logger.error('bear-delete-tag failed:', error);
+        throw error;
+    }
+});
 async function main() {
     logger.info(`Bear Notes MCP Server initializing... Version: ${APP_VERSION}`);
     logger.debug(`Debug logs enabled: ${logger.debug.enabled}`);

package/dist/notes.js

@@ -91,28 +91,25 @@ export function getNoteContent(identifier) {
         // Process multiple rows (note + files) into single note object
         const firstRow = rows[0];
         const formattedNote = formatBearNote(firstRow);
-        // Collect file content from all rows with clear source labeling
-        const fileContents = [];
+        // Collect file content into a structured array — kept separate from note text
+        // to prevent the synthetic file section from leaking into write operations (#86)
+        const files = [];
         for (const row of rows) {
             const rowData = row;
             const filename = rowData.filename;
             const fileContent = rowData.fileContent;
-            if (filename && fileContent && fileContent.trim()) {
-                fileContents.push(`##${filename}\n\n${fileContent.trim()}`);
+            if (filename) {
+                const trimmed = fileContent?.trim();
+                const content = trimmed
+                    ? trimmed
+                    : '*[File content not available — Bear has not extracted text from this file type]*';
+                files.push({ filename, content });
             }
         }
-        // Always append file content section, even if empty, to show structure
-        const originalText = formattedNote.text || '';
-        const filesSectionHeader = '\n\n---\n\n#Attached Files\n\n';
-        if (fileContents.length > 0) {
-            const fileSection = `${filesSectionHeader}${fileContents.join('\n\n---\n\n')}`;
-            formattedNote.text = originalText + fileSection;
+        if (files.length > 0) {
+            formattedNote.files = files;
         }
-        else {
-            // Add a note that no files are attached for clarity
-            formattedNote.text = originalText + `${filesSectionHeader}*No files attached to this note.*`;
-        }
-        logger.info(`Retrieved note content with ${fileContents.length} attached files for: ${formattedNote.title}`);
+        logger.info(`Retrieved note content with ${files.length} attached files for: ${formattedNote.title}`);
         return formattedNote;
     }
     catch (error) {

package/dist/tags.js

@@ -21,14 +21,12 @@ function getTagDisplayName(fullPath) {
 /**
  * Builds a hierarchical tree from a flat list of tags.
  * Tags with paths like "career/content" become children of "career".
- * Tags with 0 notes are excluded (matches Bear UI behavior).
+ * Caller is responsible for excluding zero-count tags before passing data here.
  */
 function buildTagHierarchy(flatTags) {
-    // Filter out tags with no notes (hidden in Bear UI)
-    const activeTags = flatTags.filter((t) => t.noteCount > 0);
     const tagMap = new Map();
     // Two-pass approach: first create nodes, then link parent-child relationships
-    for (const tag of activeTags) {
+    for (const tag of flatTags) {
         tagMap.set(tag.name, {
             name: tag.name,
             displayName: tag.displayName,
@@ -38,7 +36,7 @@ function buildTagHierarchy(flatTags) {
     }
     const roots = [];
     // Build parent-child relationships
-    for (const tag of activeTags) {
+    for (const tag of flatTags) {
         const tagNode = tagMap.get(tag.name);
         if (tag.isRoot) {
             roots.push(tagNode);
@@ -82,10 +80,15 @@ export function listTags() {
         const query = `
       SELECT t.ZTITLE as name,
              t.ZISROOT as isRoot,
-             COUNT(nt.Z_5NOTES) as noteCount
+             COUNT(note.Z_PK) as noteCount
       FROM ZSFNOTETAG t
       LEFT JOIN Z_5TAGS nt ON nt.Z_13TAGS = t.Z_PK
+      LEFT JOIN ZSFNOTE note ON note.Z_PK = nt.Z_5NOTES
+        AND note.ZTRASHED = 0
+        AND note.ZARCHIVED = 0
+        AND note.ZENCRYPTED = 0
       GROUP BY t.Z_PK
+      HAVING noteCount > 0
       ORDER BY t.ZTITLE
     `;
         const stmt = db.prepare(query);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bear-notes-mcp",
-  "version": "2.7.0",
+  "version": "2.8.1",
   "description": "Bear Notes MCP server with TypeScript and native SQLite",
   "type": "module",
   "main": "dist/main.js",