bear-notes-mcp 2.6.0 → 2.7.0

package/dist/config.js

@@ -1,4 +1,4 @@
-export const APP_VERSION = '2.6.0';
+export const APP_VERSION = '2.7.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}

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, '+', ' ')))";
 /**
@@ -115,13 +120,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 +256,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)
@@ -112,13 +112,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 +161,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.7.0",
   "description": "Bear Notes MCP server with TypeScript and native SQLite",
   "type": "module",
   "main": "dist/main.js",