bear-notes-mcp 2.6.0 → 2.8.0

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.6.0';
+export const APP_VERSION = '2.8.0';
 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/database.js

@@ -19,6 +19,19 @@ function getBearDatabasePath() {
     logger.debug(`Using default Bear database path: ${defaultPath}`);
     return defaultPath;
 }
+/**
+ * Closes a Bear database connection, logging but swallowing close errors.
+ * Centralizes the try/catch-close pattern used after every DB operation.
+ */
+export function closeBearDatabase(db) {
+    try {
+        db.close();
+        logger.debug('Database connection closed');
+    }
+    catch (closeError) {
+        logger.error(`Failed to close database connection: ${closeError}`);
+    }
+}
 /**
  * Opens a read-only connection to Bear's SQLite database.
  *

package/dist/main.js

@@ -5,7 +5,7 @@ import { z } from 'zod';
 import { APP_VERSION, ENABLE_CONTENT_REPLACEMENT, ENABLE_NEW_NOTE_CONVENTIONS } from './config.js';
 import { applyNoteConventions } from './note-conventions.js';
 import { cleanBase64, createToolResponse, handleNoteTextUpdate, logger } from './utils.js';
-import { getNoteContent, searchNotes } from './notes.js';
+import { awaitNoteCreation, getNoteContent, searchNotes } from './notes.js';
 import { findUntaggedNotes, listTags } from './tags.js';
 import { buildBearUrl, executeBearXCallbackApi } from './bear-urls.js';
 const server = new McpServer({
@@ -65,7 +65,7 @@ ${noteText}`);
 });
 server.registerTool('bear-create-note', {
     title: 'Create New Note',
-    description: 'Create a new note in your Bear library with optional title, content, and tags. The note will be immediately available in Bear app.',
+    description: 'Create a new note in your Bear library with optional title, content, and tags. Returns the note ID when a title is provided, enabling immediate follow-up operations. The note will be immediately available in Bear app.',
     inputSchema: {
         title: z
             .string()
@@ -98,16 +98,17 @@ server.registerTool('bear-create-note', {
             : { text, tags };
         const url = buildBearUrl('create', { title, text: createText, tags: createTags });
         await executeBearXCallbackApi(url);
+        const createdNoteId = title ? await awaitNoteCreation(title) : undefined;
         const responseLines = ['Bear note created successfully!', ''];
         if (title) {
             responseLines.push(`Title: "${title}"`);
         }
-        if (text) {
-            responseLines.push(`Content: ${text.length} characters`);
-        }
         if (tags) {
             responseLines.push(`Tags: ${tags}`);
         }
+        if (createdNoteId) {
+            responseLines.push(`Note ID: ${createdNoteId}`);
+        }
         const hasContent = title || text || tags;
         const finalMessage = hasContent ? responseLines.join('\n') : 'Empty note created';
         return createToolResponse(`${finalMessage}
@@ -545,6 +546,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

@@ -1,6 +1,11 @@
+import { setTimeout } from 'node:timers/promises';
 import { DEFAULT_SEARCH_LIMIT } from './config.js';
 import { convertCoreDataTimestamp, convertDateToCoreDataTimestamp, logAndThrow, logger, parseDateString, } from './utils.js';
-import { openBearDatabase } from './database.js';
+import { closeBearDatabase, openBearDatabase } from './database.js';
+const POLL_INTERVAL_MS = 25;
+const POLL_TIMEOUT_MS = 2_000;
+// Safety window wider than POLL_TIMEOUT_MS to avoid matching a stale note with the same title
+const CREATION_LOOKBACK_MS = 10_000;
 // SQL equivalent of decodeTagName() in tags.ts — both MUST apply the same transformations
 const DECODED_TAG_TITLE = "LOWER(TRIM(REPLACE(t.ZTITLE, '+', ' ')))";
 /**
@@ -92,8 +97,12 @@ export function getNoteContent(identifier) {
             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]*';
+                fileContents.push(`##${filename}\n\n${content}`);
             }
         }
         // Always append file content section, even if empty, to show structure
@@ -115,13 +124,7 @@ export function getNoteContent(identifier) {
         logAndThrow(`Database error: Failed to retrieve note content: ${error instanceof Error ? error.message : String(error)}`);
     }
     finally {
-        try {
-            db.close();
-            logger.debug('Database connection closed');
-        }
-        catch (closeError) {
-            logger.error(`Failed to close database connection: ${closeError}`);
-        }
+        closeBearDatabase(db);
     }
     return null;
 }
@@ -257,13 +260,55 @@ export function searchNotes(searchTerm, tag, limit, dateFilter, pinned) {
         logAndThrow(`SQLite search query failed: ${error instanceof Error ? error.message : String(error)}`);
     }
     finally {
-        try {
-            db.close();
-            logger.debug('Database connection closed');
-        }
-        catch (closeError) {
-            logger.error(`Failed to close database connection: ${closeError}`);
-        }
+        closeBearDatabase(db);
     }
     return { notes: [], totalCount: 0 };
 }
+/**
+ * Polls Bear's SQLite database for the identifier of a recently created note.
+ * Designed for use after bear-create-note fires the URL API — the note creation already
+ * succeeded, so errors here degrade gracefully to null instead of throwing.
+ *
+ * @param title - Exact title to match (case-sensitive, as Bear stores it)
+ * @returns The created note's identifier, or null if not found within the timeout window
+ */
+export async function awaitNoteCreation(title) {
+    if (!title?.trim()) {
+        logger.debug('awaitNoteCreation: skipped — no title provided');
+        return null;
+    }
+    logger.debug(`awaitNoteCreation: polling for note "${title}"`);
+    const sinceTimestamp = convertDateToCoreDataTimestamp(new Date(Date.now() - CREATION_LOOKBACK_MS));
+    let db;
+    try {
+        db = openBearDatabase();
+        const stmt = db.prepare(`
+      SELECT ZUNIQUEIDENTIFIER as identifier
+      FROM ZSFNOTE
+      WHERE ZTITLE = ? AND ZCREATIONDATE >= ?
+        AND ZARCHIVED = 0 AND ZTRASHED = 0 AND ZENCRYPTED = 0
+      ORDER BY ZCREATIONDATE DESC LIMIT 1
+    `);
+        const deadline = Date.now() + POLL_TIMEOUT_MS;
+        while (Date.now() < deadline) {
+            const row = stmt.get(title, sinceTimestamp);
+            if (row) {
+                logger.debug(`awaitNoteCreation: found note "${title}"`);
+                return row.identifier;
+            }
+            await setTimeout(POLL_INTERVAL_MS);
+        }
+        logger.info(`awaitNoteCreation: timed out waiting for note "${title}"`);
+        return null;
+    }
+    catch (error) {
+        // Intentionally not using logAndThrow — the note was already created via URL API,
+        // failing to retrieve its ID should not turn a successful creation into an error
+        logger.error('awaitNoteCreation failed:', error);
+        return null;
+    }
+    finally {
+        if (db)
+            closeBearDatabase(db);
+    }
+}

package/dist/tags.js

@@ -1,5 +1,5 @@
 import { convertCoreDataTimestamp, logAndThrow, logger } from './utils.js';
-import { openBearDatabase } from './database.js';
+import { closeBearDatabase, openBearDatabase } from './database.js';
 /**
  * Decodes and normalizes Bear tag names.
  * - Replaces '+' with spaces (Bear's URL encoding)
@@ -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);
@@ -112,13 +115,7 @@ export function listTags() {
         logAndThrow(`Database error: Failed to retrieve tags: ${error instanceof Error ? error.message : String(error)}`);
     }
     finally {
-        try {
-            db.close();
-            logger.debug('Database connection closed');
-        }
-        catch (closeError) {
-            logger.error(`Failed to close database connection: ${closeError}`);
-        }
+        closeBearDatabase(db);
     }
     return { tags: [], totalCount: 0 };
 }
@@ -167,13 +164,7 @@ export function findUntaggedNotes(limit = 50) {
         logAndThrow(`Database error: Failed to find untagged notes: ${error instanceof Error ? error.message : String(error)}`);
     }
     finally {
-        try {
-            db.close();
-            logger.debug('Database connection closed');
-        }
-        catch (closeError) {
-            logger.error(`Failed to close database connection: ${closeError}`);
-        }
+        closeBearDatabase(db);
     }
     return { notes: [], totalCount: 0 };
 }

package/package.json

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