apple-notes-mcp 2.8.12 → 2.8.14

package/README.md

@@ -225,6 +225,14 @@ Creates a new note in Apple Notes.
 
 > **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.
 
+> **Known limitation:** `create-note` sets the note body directly via AppleScript's
+> `body` property, which does not apply real Notes paragraph styles for interior
+> content — an `<h2>`/`<h3>` tag or a `<span style="font-size: …px">` heading span
+> in `content` renders as plain bold, styled text, not an actual Heading or
+> Subheading ([#172](https://github.com/sweetrb/apple-notes-mcp/issues/172)). Real
+> Heading/Subheading styles can currently only be added to a note that already
+> exists, with [`append-native`](#append-native)'s `format: "markdown"`.
+
 **Returns:** Confirmation message with note title and ID. Save the ID for subsequent operations like `update-note`, `delete-note`, etc.
 
 ---
@@ -1066,9 +1074,14 @@ when `scopeText` is supplied. Use a distinctive phrase of plain words without
 punctuation, hashtags, or paths because Notes search may not resolve them
 literally. `format: "html"` accepts the fixed subset tabulated under
 [`append-to-note`](#append-to-note); content outside it is refused by name, with
-the accepted subset in the error. A transport failure names the Shortcut it was
-waiting on, so a missing or unapproved bridge is identified rather than guessed
-at.
+the accepted subset in the error. `format: "markdown"` accepts the same bounded
+subset as `format: "html"`'s Markdown-shaped content (`#`/`##`/`###` headings,
+flat lists, emphasis, and inline links) but is sent through Notes' own native
+Markdown importer rather than converted to HTML first, so `#`/`##`/`###`
+produce real Title/Heading/Subheading — Notes' HTML importer only
+distinguishes two heading levels and renders `###` the same as `##`. A
+transport failure names the Shortcut it was waiting on, so a missing or
+unapproved bridge is identified rather than guessed at.
 
 #### `create-checklist-item`
 

package/build/index.js

@@ -39708,7 +39708,7 @@ function visibleCharacters(html) {
     token++;
     if (part[0].startsWith("<")) continue;
     for (const item of part[0].matchAll(
-      /&(?:#[0-9]+;?|#x[0-9a-f]+;?|(?:amp|lt|gt|quot|apos|nbsp)(?:;|(?![a-z0-9=])))|[\s\S]/gi
+      /&(?:#[0-9]+;?|#x[0-9a-f]+;?|(?:amp|lt|gt|quot|nbsp);?|apos;)|[\s\S]/gi
     )) {
       const value = decodeEntity(item[0]);
       for (let i = 0; i < value.length; i++) {
@@ -39770,7 +39770,8 @@ function enrichNoteRead(id2, rawBody) {
         warning: "Native tags, inline objects or checklists are present. Their state is not writable through AppleScript; full-body edits are blocked to preserve them."
       } : {}
     };
-  } catch {
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
     return {
       content: rawBody,
       links: metadata?.links ?? [],
@@ -39778,7 +39779,7 @@ function enrichNoteRead(id2, rawBody) {
       complete: false,
       writable: false,
       revision: metadata?.revision ?? "unavailable",
-      warning: "Rich Notes metadata could not be read or matched. Links/native tags may be missing from this view. Full-body edits are blocked; check Full Disk Access and retry after sync."
+      warning: `Rich Notes metadata could not be read or matched. Links/native tags may be missing from this view. Full-body edits are blocked; check Full Disk Access and retry after sync. (${detail})`
     };
   }
 }
@@ -39799,10 +39800,12 @@ function htmlLinks(html) {
   }
   return links;
 }
+var BARE_HTTP_ORIGIN = /^https?:\/\/[^/?#]+$/i;
+var normalizedUrl = (url) => BARE_HTTP_ORIGIN.test(url) ? `${url}/` : url;
 function linkSignature(links) {
   return JSON.stringify(
     links.flatMap(
-      (link) => normalized(link.text).split("").map((char) => [char, link.url])
+      (link) => normalized(link.text).split("").map((char) => [char, normalizedUrl(link.url)])
     )
   );
 }
@@ -43156,15 +43159,10 @@ function assertAppendedVisibleText(beforeHtml, afterHtml, expected) {
 }
 function appendNative(manager, request) {
   validateAppendContent(request.content, request.format);
-  if (request.format === "markdown")
-    return appendNative(manager, {
-      ...request,
-      content: appendMarkdownHtml(request.content),
-      format: "html"
-    });
   if (request.format === "html" && /<table\b/i.test(request.content))
     throw new Error("Use create-table for verified native table insertion");
-  const op = request.format === "plaintext" ? "append-text" : request.format === "html" ? "append-html" : "append-markdown";
+  const markdownHtml = request.format === "markdown" ? appendMarkdownHtml(request.content) : null;
+  const op = request.format === "plaintext" ? "append-text" : request.format === "markdown" ? "append-markdown" : "append-html";
   const text = request.format === "html" ? "<div><br></div>" + request.content : "\n\n" + request.content;
   return mutateBackground(
     request,
@@ -43172,10 +43170,11 @@ function appendNative(manager, request) {
     { text },
     (before, after) => {
       assertPreserved(before, after, { append: true });
-      const expected = request.format === "html" ? comparableVisibleText(request.content) : request.format === "plaintext" ? request.content : null;
+      const verifyHtml = markdownHtml ?? request.content;
+      const expected = request.format === "plaintext" ? request.content : comparableVisibleText(verifyHtml);
       if (expected) assertAppendedVisibleText(before.html, after.html, expected);
-      if (request.format === "html")
-        assertAppendedHtmlLinks(before.rich.links.length, after.rich.links, request.content);
+      if (request.format === "html" || request.format === "markdown")
+        assertAppendedHtmlLinks(before.rich.links.length, after.rich.links, verifyHtml);
     },
     backgroundDependencies(manager)
   );

package/package.json

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