bear-notes-mcp 2.2.0 → 2.4.0

package/README.md

@@ -1,23 +1,32 @@
 # Bear Notes MCP Server
 
-Search, read, and update your Bear Notes
+Search, read, create, and update your Bear Notes from any AI assistant.
 
-Want to use this Bear Notes MCP server with Claude Code, Cursor, Codex, or other AI assistants? You can run it as a standalone MCP server.
+**Full documentation and source code: [claude-desktop-extension-bear-notes](https://github.com/vasylenko/claude-desktop-extension-bear-notes)**
 
-**Read more about the project here -- [claude-desktop-extension-bear-notes](https://github.com/vasylenko/claude-desktop-extension-bear-notes)**
+## Key Features
+
+- **9 MCP tools** for full Bear Notes integration
+- **OCR search** across images and PDFs attached to notes
+- **Date-based search** with relative dates ("yesterday", "last week", etc.)
+- **Configurable new note convention** for tag placement (opt-in)
+- **Local-only** — no network calls, all data stays on your Mac
 
 ## Tools
 
-- **`bear-search-notes`** - Find notes by text content or tags, returns list with IDs for further actions
-- **`bear-open-note`** - Read full content of a specific note including text, formatting, and metadata
-- **`bear-create-note`** - Create new notes with optional title, content, and tags
-- **`bear-add-text`** - Add text to an existing note at the beginning or end, optionally targeting a specific section
-- **`bear-add-file`** - Attach files (images, PDFs, spreadsheets, etc.) to existing notes
+<!-- TOOLS:START -->
+- **`bear-open-note`** - Read the full text content of a Bear note including OCR'd text from attached images and PDFs
+- **`bear-create-note`** - Create a new note in your Bear library with optional title, content, and tags
+- **`bear-search-notes`** - Find notes by searching text content, filtering by tags, or date ranges. Includes OCR search in attachments
+- **`bear-add-text`** - Add text to an existing Bear note at the beginning or end, optionally targeting a specific section
+- **`bear-add-file`** - Attach a file (image, PDF, Excel, etc.) to an existing Bear note using base64-encoded content
 - **`bear-list-tags`** - List all tags in your Bear library as a hierarchical tree with note counts
-- **`bear-find-untagged-notes`** - Find notes that have no tags assigned
-- **`bear-add-tag`** - Add one or more tags to an existing note
+- **`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
+<!-- TOOLS:END -->
 
-**Requirements**: Node.js 22.13.0+
+**Requirements**: Node.js 24.13.0+
 
 ## Quick Start - Claude Code (One Command)
 
@@ -41,6 +50,29 @@ Add to your MCP configuration file:
 }
 ```
 
+## Configuration
+
+| Variable | Default | Description |
+|---|---|---|
+| `UI_DEBUG_TOGGLE` | `false` | Enable debug logging for troubleshooting |
+| `UI_ENABLE_NEW_NOTE_CONVENTION` | `false` | Place tags right after the note title instead of at the bottom |
+
+Example with configuration:
+```json
+{
+  "mcpServers": {
+    "bear-notes": {
+      "command": "npx",
+      "args": ["-y", "bear-notes-mcp@latest"],
+      "env": {
+        "UI_ENABLE_NEW_NOTE_CONVENTION": "true",
+        "UI_DEBUG_TOGGLE": "true"
+      }
+    }
+  }
+}
+```
+
 ## Advanced: Local Development Build
 
 **Step 1: Clone and build**

package/dist/config.js

@@ -1,11 +1,9 @@
-export const APP_VERSION = '2.2.0';
+export const APP_VERSION = '2.4.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;
 export const BEAR_DATABASE_PATH = 'Library/Group Containers/9K33E3U3T4.net.shinyfrog.bear/Application Data/database.sqlite';
+export const ENABLE_NEW_NOTE_CONVENTIONS = process.env.UI_ENABLE_NEW_NOTE_CONVENTION === 'true';
 export const ERROR_MESSAGES = {
     BEAR_DATABASE_NOT_FOUND: 'Bear database not found. Please ensure Bear Notes is installed and has been opened at least once.',
-    MISSING_SEARCH_PARAM: 'Please provide either a search term or a tag to search for notes.',
-    MISSING_NOTE_ID: 'Please provide a note identifier. Use bear-search-notes first to find the note ID.',
-    MISSING_TEXT_PARAM: 'Text input parameter is required and must be a non-empty string',
 };

package/dist/main.js

@@ -2,7 +2,8 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { APP_VERSION, ERROR_MESSAGES } from './config.js';
+import { APP_VERSION, ENABLE_NEW_NOTE_CONVENTIONS } from './config.js';
+import { applyNoteConventions } from './note-conventions.js';
 import { cleanBase64, createToolResponse, handleAddText, logger } from './utils.js';
 import { getNoteContent, searchNotes } from './notes.js';
 import { findUntaggedNotes, listTags } from './tags.js';
@@ -15,22 +16,23 @@ server.registerTool('bear-open-note', {
     title: 'Open Bear Note',
     description: 'Read the full text content of a Bear note from your library. Always includes text extracted from attached images and PDFs (aka OCR search) with clear labeling.',
     inputSchema: {
-        identifier: z.string().describe('Exact note identifier (ID) obtained from bear-search-notes'),
+        id: z
+            .string()
+            .trim()
+            .min(1, 'Note ID is required')
+            .describe('Exact note identifier (ID) obtained from bear-search-notes'),
     },
     annotations: {
         readOnlyHint: true,
         idempotentHint: true,
         openWorldHint: false,
     },
-}, async ({ identifier }) => {
-    logger.info(`bear-open-note called with identifier: ${identifier}, includeFiles: always`);
-    if (!identifier || !identifier.trim()) {
-        throw new Error(ERROR_MESSAGES.MISSING_NOTE_ID);
-    }
+}, async ({ id }) => {
+    logger.info(`bear-open-note called with id: ${id}, includeFiles: always`);
     try {
-        const noteWithContent = getNoteContent(identifier.trim());
+        const noteWithContent = getNoteContent(id);
         if (!noteWithContent) {
-            return createToolResponse(`Note with ID '${identifier}' not found. The note may have been deleted, archived, or the ID may be incorrect.
+            return createToolResponse(`Note with ID '${id}' not found. The note may have been deleted, archived, or the ID may be incorrect.
 
 Use bear-search-notes to find the correct note identifier.`);
         }
@@ -47,7 +49,7 @@ Use bear-search-notes to find the correct note identifier.`);
 ${noteText}`);
     }
     catch (error) {
-        logger.error(`bear-open-note failed: ${error}`);
+        logger.error('bear-open-note failed:', error);
         throw error;
     }
 });
@@ -57,10 +59,19 @@ server.registerTool('bear-create-note', {
     inputSchema: {
         title: z
             .string()
+            .trim()
             .optional()
             .describe('Note title, e.g., "Meeting Notes" or "Research Ideas"'),
-        text: z.string().optional().describe('Note content in markdown format'),
-        tags: z.string().optional().describe('Tags separated by commas, e.g., "work,project,urgent"'),
+        text: z
+            .string()
+            .trim()
+            .optional()
+            .describe('Note content in markdown format. Do not include a title heading — Bear adds it automatically from the title parameter.'),
+        tags: z
+            .string()
+            .trim()
+            .optional()
+            .describe('Tags separated by commas, e.g., "work,project,urgent"'),
     },
     annotations: {
         readOnlyHint: false,
@@ -71,26 +82,30 @@ server.registerTool('bear-create-note', {
 }, async ({ title, text, tags }) => {
     logger.debug(`bear-create-note called with title: ${title ? '"' + title + '"' : 'none'}, text length: ${text ? text.length : 0}, tags: ${tags || 'none'}`);
     try {
-        const url = buildBearUrl('create', { title, text, tags });
+        // If ENABLE_NOTE_CONVENTIONS is true, embed tags in the text body using Bear's inline tag syntax, rather than passing as URL parameters
+        const { text: createText, tags: createTags } = ENABLE_NEW_NOTE_CONVENTIONS
+            ? applyNoteConventions({ text, tags })
+            : { text, tags };
+        const url = buildBearUrl('create', { title, text: createText, tags: createTags });
         await executeBearXCallbackApi(url);
         const responseLines = ['Bear note created successfully!', ''];
-        if (title?.trim()) {
-            responseLines.push(`Title: "${title.trim()}"`);
+        if (title) {
+            responseLines.push(`Title: "${title}"`);
         }
-        if (text?.trim()) {
-            responseLines.push(`Content: ${text.trim().length} characters`);
+        if (text) {
+            responseLines.push(`Content: ${text.length} characters`);
         }
-        if (tags?.trim()) {
-            responseLines.push(`Tags: ${tags.trim()}`);
+        if (tags) {
+            responseLines.push(`Tags: ${tags}`);
         }
-        const hasContent = title?.trim() || text?.trim() || tags?.trim();
+        const hasContent = title || text || tags;
         const finalMessage = hasContent ? responseLines.join('\n') : 'Empty note created';
         return createToolResponse(`${finalMessage}
 
 The note has been added to your Bear Notes library.`);
     }
     catch (error) {
-        logger.error(`bear-create-note failed: ${error}`);
+        logger.error('bear-create-note failed:', error);
         throw error;
     }
 });
@@ -98,8 +113,8 @@ server.registerTool('bear-search-notes', {
     title: 'Find Bear Notes',
     description: 'Find notes in your Bear library by searching text content, filtering by tags, or date ranges. Always searches within attached images and PDF files via OCR. Returns a list with titles and IDs - use "Open Bear Note" to read full content.',
     inputSchema: {
-        term: z.string().optional().describe('Text to search for in note titles and content'),
-        tag: z.string().optional().describe('Tag to filter notes by (without # symbol)'),
+        term: z.string().trim().optional().describe('Text to search for in note titles and content'),
+        tag: z.string().trim().optional().describe('Tag to filter notes by (without # symbol)'),
         limit: z.number().optional().describe('Maximum number of results to return (default: 50)'),
         createdAfter: z
             .string()
@@ -139,10 +154,10 @@ server.registerTool('bear-search-notes', {
         const { notes, totalCount } = searchNotes(term, tag, limit, Object.keys(dateFilter).length > 0 ? dateFilter : undefined, pinned);
         if (notes.length === 0) {
             const searchCriteria = [];
-            if (term?.trim())
-                searchCriteria.push(`term "${term.trim()}"`);
-            if (tag?.trim())
-                searchCriteria.push(`tag "${tag.trim()}"`);
+            if (term)
+                searchCriteria.push(`term "${term}"`);
+            if (tag)
+                searchCriteria.push(`tag "${tag}"`);
             if (createdAfter)
                 searchCriteria.push(`created after "${createdAfter}"`);
             if (createdBefore)
@@ -180,7 +195,7 @@ Try different search criteria or check if notes exist in Bear Notes.`);
         return createToolResponse(resultLines.join('\n'));
     }
     catch (error) {
-        logger.error(`bear-search-notes failed: ${error}`);
+        logger.error('bear-search-notes failed:', error);
         throw error;
     }
 });
@@ -188,10 +203,19 @@ server.registerTool('bear-add-text', {
     title: 'Add Text to Note',
     description: 'Add text to an existing Bear note at the beginning or end. Can target a specific section using header. Use bear-search-notes first to get the note ID.',
     inputSchema: {
-        id: z.string().describe('Note identifier (ID) from bear-search-notes'),
-        text: z.string().describe('Text content to add to the note'),
+        id: z
+            .string()
+            .trim()
+            .min(1, 'Note ID is required')
+            .describe('Note identifier (ID) from bear-search-notes'),
+        text: z
+            .string()
+            .trim()
+            .min(1, 'Text content is required')
+            .describe('Text content to add to the note'),
         header: z
             .string()
+            .trim()
             .optional()
             .describe('Optional section header to target (adds text within that section)'),
         position: z
@@ -213,13 +237,22 @@ server.registerTool('bear-add-file', {
     title: 'Add File to Note',
     description: 'Attach a file to an existing Bear note. Encode the file to base64 using shell commands (e.g., base64 /path/to/file.xlsx) and provide the encoded content. Use bear-search-notes first to get the note ID.',
     inputSchema: {
-        base64_content: z.string().describe('Base64-encoded file content'),
-        filename: z.string().describe('Filename with extension (e.g., budget.xlsx, report.pdf)'),
+        base64_content: z
+            .string()
+            .trim()
+            .min(1, 'Base64 file content is required')
+            .describe('Base64-encoded file content'),
+        filename: z
+            .string()
+            .trim()
+            .min(1, 'Filename is required')
+            .describe('Filename with extension (e.g., budget.xlsx, report.pdf)'),
         id: z
             .string()
+            .trim()
             .optional()
             .describe('Exact note identifier (ID) obtained from bear-search-notes'),
-        title: z.string().optional().describe('Note title if ID is not available'),
+        title: z.string().trim().optional().describe('Note title if ID is not available'),
     },
     annotations: {
         readOnlyHint: false,
@@ -229,12 +262,6 @@ server.registerTool('bear-add-file', {
     },
 }, async ({ base64_content, filename, id, title }) => {
     logger.info(`bear-add-file called with base64_content: ${base64_content ? 'provided' : 'none'}, filename: ${filename || 'none'}, id: ${id || 'none'}, title: ${title || 'none'}`);
-    if (!base64_content || !base64_content.trim()) {
-        throw new Error('base64_content is required');
-    }
-    if (!filename || !filename.trim()) {
-        throw new Error('filename is required');
-    }
     if (!id && !title) {
         throw new Error('Either note ID or title is required. Use bear-search-notes to find the note ID.');
     }
@@ -243,7 +270,7 @@ server.registerTool('bear-add-file', {
         const cleanedBase64 = cleanBase64(base64_content);
         // Fail fast with helpful message rather than cryptic Bear error
         if (id) {
-            const existingNote = getNoteContent(id.trim());
+            const existingNote = getNoteContent(id);
             if (!existingNote) {
                 return createToolResponse(`Note with ID '${id}' not found. The note may have been deleted, archived, or the ID may be incorrect.
 
@@ -251,23 +278,23 @@ Use bear-search-notes to find the correct note identifier.`);
             }
         }
         const url = buildBearUrl('add-file', {
-            id: id?.trim(),
-            title: title?.trim(),
+            id,
+            title,
             file: cleanedBase64,
-            filename: filename.trim(),
+            filename,
             mode: 'append',
         });
-        logger.debug(`Executing Bear add-file URL for: ${filename.trim()}`);
+        logger.debug(`Executing Bear add-file URL for: ${filename}`);
         await executeBearXCallbackApi(url);
-        const noteIdentifier = id ? `Note ID: ${id.trim()}` : `Note title: "${title.trim()}"`;
-        return createToolResponse(`File "${filename.trim()}" added successfully!
+        const noteIdentifier = id ? `Note ID: ${id}` : `Note title: "${title}"`;
+        return createToolResponse(`File "${filename}" added successfully!
 
 ${noteIdentifier}
 
 The file has been attached to your Bear note.`);
     }
     catch (error) {
-        logger.error(`bear-add-file failed: ${error}`);
+        logger.error('bear-add-file failed:', error);
         throw error;
     }
 });
@@ -321,7 +348,7 @@ server.registerTool('bear-list-tags', {
         return createToolResponse(header + '\n' + lines.join('\n'));
     }
     catch (error) {
-        logger.error(`bear-list-tags failed: ${error}`);
+        logger.error('bear-list-tags failed:', error);
         throw error;
     }
 });
@@ -363,7 +390,7 @@ server.registerTool('bear-find-untagged-notes', {
         return createToolResponse(lines.join('\n'));
     }
     catch (error) {
-        logger.error(`bear-find-untagged-notes failed: ${error}`);
+        logger.error('bear-find-untagged-notes failed:', error);
         throw error;
     }
 });
@@ -373,9 +400,12 @@ server.registerTool('bear-add-tag', {
     inputSchema: {
         id: z
             .string()
+            .trim()
+            .min(1, 'Note ID is required')
             .describe('Note identifier (ID) from bear-search-notes or bear-find-untagged-notes'),
         tags: z
-            .array(z.string())
+            .array(z.string().trim().min(1, 'Tag name cannot be empty'))
+            .min(1, 'At least one tag is required')
             .describe('Tag names without # symbol (e.g., ["career", "career/meetings"])'),
     },
     annotations: {
@@ -386,14 +416,8 @@ server.registerTool('bear-add-tag', {
     },
 }, async ({ id, tags }) => {
     logger.info(`bear-add-tag called with id: ${id}, tags: [${tags.join(', ')}]`);
-    if (!id || !id.trim()) {
-        throw new Error(ERROR_MESSAGES.MISSING_NOTE_ID);
-    }
-    if (!tags || tags.length === 0) {
-        throw new Error('At least one tag is required');
-    }
     try {
-        const existingNote = getNoteContent(id.trim());
+        const existingNote = getNoteContent(id);
         if (!existingNote) {
             return createToolResponse(`Note with ID '${id}' not found. The note may have been deleted, archived, or the ID may be incorrect.
 
@@ -401,7 +425,7 @@ Use bear-search-notes to find the correct note identifier.`);
         }
         const tagsString = tags.join(',');
         const url = buildBearUrl('add-text', {
-            id: id.trim(),
+            id,
             tags: tagsString,
             mode: 'prepend',
             open_note: 'no',
@@ -418,7 +442,49 @@ Tags: ${tagList}
 The tags have been added to the beginning of the note.`);
     }
     catch (error) {
-        logger.error(`bear-add-tag failed: ${error}`);
+        logger.error('bear-add-tag failed:', error);
+        throw error;
+    }
+});
+server.registerTool('bear-archive-note', {
+    title: 'Archive Bear Note',
+    description: "Move a note to Bear's archive. The note will no longer appear in regular searches but can be found in Bear's Archive section. Use bear-search-notes first to get the note ID.",
+    inputSchema: {
+        id: z
+            .string()
+            .trim()
+            .min(1, 'Note ID is required')
+            .describe('Note identifier (ID) from bear-search-notes or bear-open-note'),
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async ({ id }) => {
+    logger.info(`bear-archive-note called with id: ${id}`);
+    try {
+        const existingNote = getNoteContent(id);
+        if (!existingNote) {
+            return createToolResponse(`Note with ID '${id}' not found. The note may have been deleted, archived, or the ID may be incorrect.
+
+Use bear-search-notes to find the correct note identifier.`);
+        }
+        const url = buildBearUrl('archive', {
+            id,
+            show_window: 'no',
+        });
+        await executeBearXCallbackApi(url);
+        return createToolResponse(`Note archived successfully!
+
+Note: "${existingNote.title}"
+ID: ${id}
+
+The note has been moved to Bear's archive.`);
+    }
+    catch (error) {
+        logger.error('bear-archive-note failed:', error);
         throw error;
     }
 });

package/dist/note-conventions.js

@@ -0,0 +1,35 @@
+/**
+ * Applies note creation conventions by embedding tags as Bear inline syntax
+ * at the start of the text body, rather than passing them as URL parameters
+ * (which places them at the bottom of the note).
+ */
+export function applyNoteConventions(input) {
+    if (!input.tags) {
+        return { text: input.text, tags: undefined };
+    }
+    const tagLine = input.tags
+        .split(',')
+        .map((t) => t.trim())
+        .filter(Boolean)
+        .map(toBearTagSyntax)
+        .filter(Boolean)
+        .join(' ');
+    // All tags were invalid (e.g., "###,,,") — pass text through unchanged
+    if (!tagLine) {
+        return { text: input.text, tags: undefined };
+    }
+    const text = input.text ? `${tagLine}\n---\n${input.text}` : tagLine;
+    return { text, tags: undefined };
+}
+/**
+ * Bear uses `#tag` for simple tags and `#tag#` (closing hash) for
+ * multi-word tags containing spaces. Slashes create hierarchy without
+ * requiring a closing hash.
+ */
+function toBearTagSyntax(raw) {
+    const cleaned = raw.replace(/^#+|#+$/g, '').trim();
+    if (!cleaned)
+        return '';
+    const needsClosingHash = cleaned.includes(' ');
+    return needsClosingHash ? `#${cleaned}#` : `#${cleaned}`;
+}

package/dist/note-conventions.test.js

@@ -0,0 +1,78 @@
+import { describe, expect, it } from 'vitest';
+import { applyNoteConventions } from './note-conventions.js';
+describe('applyNoteConventions', () => {
+    describe('pass-through when no tags provided', () => {
+        it('undefined tags returns text unchanged', () => {
+            const result = applyNoteConventions({ text: 'hello', tags: undefined });
+            expect(result).toEqual({ text: 'hello', tags: undefined });
+        });
+        it('empty string tags returns text unchanged', () => {
+            const result = applyNoteConventions({ text: 'hello', tags: '' });
+            expect(result).toEqual({ text: 'hello', tags: undefined });
+        });
+        it('both text and tags undefined returns both unchanged', () => {
+            const result = applyNoteConventions({ text: undefined, tags: undefined });
+            expect(result).toEqual({ text: undefined, tags: undefined });
+        });
+    });
+    describe('tags only, no text', () => {
+        it('multiple tags produce tag line without separator', () => {
+            const result = applyNoteConventions({ text: undefined, tags: 'work,urgent' });
+            expect(result).toEqual({ text: '#work #urgent', tags: undefined });
+        });
+        it('empty string text treated as no text', () => {
+            const result = applyNoteConventions({ text: '', tags: 'work' });
+            expect(result).toEqual({ text: '#work', tags: undefined });
+        });
+    });
+    describe('tags + text composition', () => {
+        it('multiple tags and text joined with separator', () => {
+            const result = applyNoteConventions({ text: 'body', tags: 'work,urgent' });
+            expect(result).toEqual({ text: '#work #urgent\n---\nbody', tags: undefined });
+        });
+        it('single tag and text joined with separator', () => {
+            const result = applyNoteConventions({ text: 'body', tags: 'work' });
+            expect(result).toEqual({ text: '#work\n---\nbody', tags: undefined });
+        });
+    });
+    describe('closing hash rules', () => {
+        it('nested tag without spaces has no closing hash', () => {
+            const result = applyNoteConventions({ text: undefined, tags: 'work/meetings' });
+            expect(result).toEqual({ text: '#work/meetings', tags: undefined });
+        });
+        it('tag with space gets closing hash', () => {
+            const result = applyNoteConventions({ text: undefined, tags: 'my tag' });
+            expect(result).toEqual({ text: '#my tag#', tags: undefined });
+        });
+        it('nested tag with spaces gets closing hash', () => {
+            const result = applyNoteConventions({ text: undefined, tags: 'work/meeting notes' });
+            expect(result).toEqual({ text: '#work/meeting notes#', tags: undefined });
+        });
+        it('simple tag has no closing hash', () => {
+            const result = applyNoteConventions({ text: undefined, tags: 'urgent' });
+            expect(result).toEqual({ text: '#urgent', tags: undefined });
+        });
+        it('mixed tags apply closing hash per-tag', () => {
+            const result = applyNoteConventions({ text: undefined, tags: 'work/meetings,urgent,my tag' });
+            expect(result).toEqual({ text: '#work/meetings #urgent #my tag#', tags: undefined });
+        });
+    });
+    describe('tag cleanup edge cases', () => {
+        it('strips leading and trailing hash symbols from tags', () => {
+            const result = applyNoteConventions({ text: undefined, tags: '#work,##urgent#' });
+            expect(result).toEqual({ text: '#work #urgent', tags: undefined });
+        });
+        it('all-invalid tags pass text through unchanged', () => {
+            const result = applyNoteConventions({ text: 'hello', tags: '###,,,  ' });
+            expect(result).toEqual({ text: 'hello', tags: undefined });
+        });
+        it('empty segments between commas are filtered out', () => {
+            const result = applyNoteConventions({ text: undefined, tags: 'work, , ,urgent' });
+            expect(result).toEqual({ text: '#work #urgent', tags: undefined });
+        });
+        it('whitespace around tags is trimmed', () => {
+            const result = applyNoteConventions({ text: undefined, tags: ' work , urgent ' });
+            expect(result).toEqual({ text: '#work #urgent', tags: undefined });
+        });
+    });
+});

package/dist/utils.js

@@ -1,5 +1,5 @@
 import createDebug from 'debug';
-import { CORE_DATA_EPOCH_OFFSET, ERROR_MESSAGES } from './config.js';
+import { CORE_DATA_EPOCH_OFFSET } from './config.js';
 import { getNoteContent } from './notes.js';
 import { buildBearUrl, executeBearXCallbackApi } from './bear-urls.js';
 export const logger = {
@@ -144,35 +144,29 @@ export function createToolResponse(text) {
 export async function handleAddText(mode, { id, text, header }) {
     const action = mode === 'append' ? 'appended' : 'prepended';
     logger.info(`bear-add-text-${mode} called with id: ${id}, text length: ${text.length}, header: ${header || 'none'}`);
-    if (!id || !id.trim()) {
-        throw new Error(ERROR_MESSAGES.MISSING_NOTE_ID);
-    }
-    if (!text || !text.trim()) {
-        throw new Error(ERROR_MESSAGES.MISSING_TEXT_PARAM);
-    }
     try {
-        const existingNote = getNoteContent(id.trim());
+        const existingNote = getNoteContent(id);
         if (!existingNote) {
             return createToolResponse(`Note with ID '${id}' not found. The note may have been deleted, archived, or the ID may be incorrect.
 
 Use bear-search-notes to find the correct note identifier.`);
         }
         // Strip markdown header syntax from header parameter for Bear API
-        const cleanHeader = header?.trim().replace(/^#+\s*/, '');
+        const cleanHeader = header?.replace(/^#+\s*/, '');
         const url = buildBearUrl('add-text', {
-            id: id.trim(),
-            text: text.trim(),
+            id,
+            text,
             header: cleanHeader,
             mode,
         });
         logger.debug(`Executing Bear URL: ${url}`);
         await executeBearXCallbackApi(url);
         const responseLines = [`Text ${action} to note "${existingNote.title}" successfully!`, ''];
-        responseLines.push(`Text: ${text.trim().length} characters`);
-        if (header?.trim()) {
-            responseLines.push(`Section: ${header.trim()}`);
+        responseLines.push(`Text: ${text.length} characters`);
+        if (header) {
+            responseLines.push(`Section: ${header}`);
         }
-        responseLines.push(`Note ID: ${id.trim()}`);
+        responseLines.push(`Note ID: ${id}`);
         return createToolResponse(`${responseLines.join('\n')}
 
 The text has been added to your Bear note.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bear-notes-mcp",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "Bear Notes MCP server with TypeScript and native SQLite",
   "type": "module",
   "main": "dist/main.js",
@@ -9,6 +9,7 @@
     "dev": "tsx src/main.ts --debug",
     "start": "node dist/main.js",
     "test": "vitest run",
+    "test:system": "npm run build && vitest run --config vitest.system.config.ts",
     "test:watch": "vitest",
     "lint": "eslint src --fix",
     "lint:check": "eslint src",
@@ -19,23 +20,24 @@
     "prepublishOnly": "npm run build && mv docs/NPM.md README.md"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@modelcontextprotocol/sdk": "^1.26.0",
     "debug": "^4.4.3",
-    "zod": "^4.3.5",
+    "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^2.1.2",
+    "@modelcontextprotocol/inspector": "^0.20.0",
     "@types/debug": "^4.1.12",
-    "@types/node": "^24.10.9",
-    "@typescript-eslint/eslint-plugin": "^8.53.0",
-    "@typescript-eslint/parser": "^8.53.0",
+    "@types/node": "^24.10.13",
+    "@typescript-eslint/eslint-plugin": "^8.55.0",
+    "@typescript-eslint/parser": "^8.55.0",
     "eslint": "^9.39.2",
     "eslint-plugin-import": "^2.32.0",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.17"
+    "vitest": "^4.0.18"
   },
   "engines": {
     "node": ">=24.13.0"