apple-notes-mcp 1.3.0 → 1.3.1

package/README.md

@@ -107,10 +107,10 @@ Creates a new note in Apple Notes.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `title` | string | Yes | The title of the note (becomes first line) |
-| `content` | string | Yes | The body content of the note |
+| `title` | string | Yes | The title of the note. Automatically prepended as `<h1>` — do NOT include the title in `content` |
+| `content` | string | Yes | The body content of the note (do not repeat the title here) |
 | `tags` | string[] | No | Tags for organization (stored in metadata) |
-| `format` | string | No | Content format: `"plaintext"` (default) or `"html"`. When `"html"`, content is used as raw HTML for rich formatting |
+| `format` | string | No | Content format: `"plaintext"` (default) or `"html"`. In both formats, the title is automatically prepended as `<h1>`. In plaintext mode, newlines become `<br>`, tabs become `<br>`, and backslashes are preserved as HTML entities |
 
 **Example:**
 ```json
@@ -125,11 +125,13 @@ Creates a new note in Apple Notes.
 ```json
 {
   "title": "Status Report",
-  "content": "<h1>Status Report</h1><h2>Summary</h2><p>All tasks <b>on track</b>.</p><ul><li>Feature A: complete</li><li>Feature B: in progress</li></ul>",
+  "content": "<h2>Summary</h2><p>All tasks <b>on track</b>.</p><ul><li>Feature A: complete</li><li>Feature B: in progress</li></ul>",
   "format": "html"
 }
 ```
 
+> **Note:** The title is automatically prepended as `<h1>` in both plaintext and HTML formats. Do not include a `<h1>` title tag in the `content` parameter, or the title will appear twice.
+
 **Returns:** Confirmation message with note title and ID. Save the ID for subsequent operations like `update-note`, `delete-note`, etc.
 
 ---
@@ -293,7 +295,7 @@ Updates an existing note's content and/or title.
 ```json
 {
   "id": "x-coredata://ABC123/ICNote/p456",
-  "newContent": "<h1>Updated Report</h1><p>New findings with <b>bold</b> emphasis.</p><pre><code>console.log('hello');</code></pre>",
+  "newContent": "<p>New findings with <b>bold</b> emphasis.</p><pre><code>console.log('hello');</code></pre>",
   "format": "html"
 }
 ```

package/build/services/appleNotesManager.js

@@ -399,32 +399,41 @@ export class AppleNotesManager {
      * // Create in a different account
      * const gmail = manager.createNote("Draft", "...", [], undefined, "Gmail");
      *
-     * // Create with HTML formatting
-     * const html = manager.createNote("Report", "<h1>Report</h1><p>Details here</p>",
+     * // Create with HTML formatting (no need for <h1> — title is auto-prepended)
+     * const html = manager.createNote("Report", "<p>Details here</p>",
      *   [], undefined, undefined, "html");
      * ```
      */
     createNote(title, content, tags = [], folder, account, format = "plaintext") {
         const targetAccount = this.resolveAccount(account);
-        // Escape content for AppleScript embedding
-        const safeTitle = escapeForAppleScript(title);
-        const safeContent = format === "html" ? escapeHtmlForAppleScript(content) : escapeForAppleScript(content);
+        // Build body HTML: title as <h1>, content follows.
+        // We set only 'body' (not 'name') to avoid title duplication —
+        // Notes.app auto-uses the first line of body as the note's display title.
+        const htmlTitle = title.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+        const bodyContent = format === "html"
+            ? content
+            : content
+                .replace(/&/g, "&amp;")
+                .replace(/\\/g, "&#92;")
+                .replace(/</g, "&lt;")
+                .replace(/>/g, "&gt;")
+                .replace(/\n/g, "<br>")
+                .replace(/\t/g, "<br>");
+        const safeBody = escapeHtmlForAppleScript(`<h1>${htmlTitle}</h1>${bodyContent}`);
         // Build the AppleScript command
-        // Notes.app uses 'name' for the title and 'body' for content
-        // We capture the ID of the newly created note
         let createCommand;
         if (folder) {
             // Create note in specific folder
             const safeFolder = escapeForAppleScript(folder);
             createCommand = `
-        set newNote to make new note at folder "${safeFolder}" with properties {name:"${safeTitle}", body:"${safeContent}"}
+        set newNote to make new note at folder "${safeFolder}" with properties {body:"${safeBody}"}
         return id of newNote
       `;
         }
         else {
             // Create note in default location
             createCommand = `
-        set newNote to make new note with properties {name:"${safeTitle}", body:"${safeContent}"}
+        set newNote to make new note with properties {body:"${safeBody}"}
         return id of newNote
       `;
         }

package/build/services/appleNotesManager.test.js

@@ -333,6 +333,62 @@ describe("AppleNotesManager", () => {
             // Double quotes must be escaped for AppleScript string embedding
             expect(mockExecuteAppleScript).toHaveBeenCalledWith(expect.stringContaining('<div class=\\"test\\">Content</div>'));
         });
+        it("sets title as h1 in body, not as name property", () => {
+            mockExecuteAppleScript.mockReturnValue({
+                success: true,
+                output: "note id x-coredata://12345/ICNote/p203",
+            });
+            manager.createNote("My Title", "Body content");
+            const script = mockExecuteAppleScript.mock.calls[0][0];
+            // Title must appear as h1 in body
+            expect(script).toContain("<h1>My Title</h1>");
+            // name property must NOT be set (causes title duplication in Notes.app)
+            expect(script).not.toContain('name:"My Title"');
+        });
+        it("HTML-encodes special chars in title for h1 tag", () => {
+            mockExecuteAppleScript.mockReturnValue({
+                success: true,
+                output: "note id x-coredata://12345/ICNote/p204",
+            });
+            manager.createNote("Q&A: <Hello> World", "Content");
+            expect(mockExecuteAppleScript).toHaveBeenCalledWith(expect.stringContaining("<h1>Q&amp;A: &lt;Hello&gt; World</h1>"));
+        });
+        it("HTML-encodes special chars in plaintext content", () => {
+            mockExecuteAppleScript.mockReturnValue({
+                success: true,
+                output: "note id x-coredata://12345/ICNote/p205",
+            });
+            manager.createNote("Title", "Price: <10 & >5\nNext line");
+            const script = mockExecuteAppleScript.mock.calls[0][0];
+            expect(script).toContain("Price: &lt;10 &amp; &gt;5<br>Next line");
+        });
+        it("prepends h1 title before html content", () => {
+            mockExecuteAppleScript.mockReturnValue({
+                success: true,
+                output: "note id x-coredata://12345/ICNote/p206",
+            });
+            manager.createNote("Report", "<h2>Section</h2><div>Details</div>", [], undefined, undefined, "html");
+            const script = mockExecuteAppleScript.mock.calls[0][0];
+            expect(script).toContain("<h1>Report</h1><h2>Section</h2><div>Details</div>");
+        });
+        it("encodes backslashes as HTML entities in plaintext content", () => {
+            mockExecuteAppleScript.mockReturnValue({
+                success: true,
+                output: "note id x-coredata://12345/ICNote/p207",
+            });
+            manager.createNote("Title", "path\\to\\file");
+            const script = mockExecuteAppleScript.mock.calls[0][0];
+            expect(script).toContain("path&#92;to&#92;file");
+        });
+        it("converts tabs to br in plaintext content", () => {
+            mockExecuteAppleScript.mockReturnValue({
+                success: true,
+                output: "note id x-coredata://12345/ICNote/p208",
+            });
+            manager.createNote("Title", "col1\tcol2\tcol3");
+            const script = mockExecuteAppleScript.mock.calls[0][0];
+            expect(script).toContain("col1<br>col2<br>col3");
+        });
     });
     // ---------------------------------------------------------------------------
     // Note Search

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-notes-mcp",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "MCP server for Apple Notes - create, search, update, and manage notes via Claude",
   "type": "module",
   "main": "build/index.js",