apple-notes-mcp 2.6.10 → 2.6.12

package/README.md

@@ -71,9 +71,24 @@ The Codex plugin runs the published `apple-notes-mcp` server through `npx` and s
 
 ### Other Hosts (Hermes, Antigravity)
 
-Configuration for two more hosts is included — each registers the same `apple-notes` MCP server (`npx -y apple-notes-mcp`):
+Two more hosts can run the same `apple-notes` MCP server (`npx -y apple-notes-mcp`):
 
-- **[Hermes Agent](https://hermes-agent.nousresearch.com/)** (NousResearch) — Hermes has no plugin/marketplace drop-in. Add the server with `hermes mcp add apple-notes --command npx --args -y apple-notes-mcp`, or merge [`.hermes-plugin/config.yaml`](https://github.com/sweetrb/apple-notes-mcp/blob/main/.hermes-plugin/config.yaml) into `~/.hermes/config.yaml`. Details: [`.hermes-plugin/README.md`](https://github.com/sweetrb/apple-notes-mcp/blob/main/.hermes-plugin/README.md).
+- **[Hermes Agent](https://hermes-agent.nousresearch.com/)** (NousResearch) — Hermes has no plugin/marketplace drop-in, so there is nothing in this repo to install from. Register the server with the CLI:
+
+  ```bash
+  hermes mcp add apple-notes --command npx --args -y apple-notes-mcp
+  ```
+
+  Or add it to `~/.hermes/config.yaml` by hand:
+
+  ```yaml
+  mcp_servers:
+    apple-notes:
+      command: npx
+      args: ["-y", "apple-notes-mcp"]
+  ```
+
+  Restart your Hermes session afterward so the tools load.
 - **[Antigravity](https://antigravity.google/)** (Google) — add the server entry from [`.antigravity-plugin/mcp_config.json`](https://github.com/sweetrb/apple-notes-mcp/blob/main/.antigravity-plugin/mcp_config.json) to `~/.gemini/config/mcp_config.json` (or via Antigravity's MCP settings).
 
 ### Using Claude Desktop

package/build/index.js

@@ -40033,7 +40033,7 @@ var AppleNotesManager = class {
       `;
   }
   /**
-   * Parses bulk listing output into deduplicated note titles.
+   * Parses bulk listing output into deduplicated (title, id) pairs.
    *
    * Duplicate CoreData references are deduped by id; the limit is applied
    * after dedup so duplicates never count against it.
@@ -40041,17 +40041,31 @@ var AppleNotesManager = class {
   parseBulkListOutput(output, safeLimit) {
     if (!output.trim()) return [];
     const seenIds = /* @__PURE__ */ new Set();
-    const titles = [];
+    const refs = [];
     for (const item of output.split(RECORD_SEP)) {
       const [title, id] = item.split(FIELD_SEP);
       if (!title?.trim()) continue;
       const noteId = id?.trim() || generateFallbackId();
       if (seenIds.has(noteId)) continue;
       seenIds.add(noteId);
-      titles.push(title.trim());
-      if (safeLimit !== void 0 && titles.length >= safeLimit) break;
+      refs.push({ title: title.trim(), id: noteId });
+      if (safeLimit !== void 0 && refs.length >= safeLimit) break;
     }
-    return titles;
+    return refs;
+  }
+  /**
+   * Lists all notes in an account/folder as (title, id) pairs, unfiltered
+   * and unlimited. Used internally where the id is needed to avoid
+   * re-resolving identity by (possibly duplicated) title — see exportNotesAsJson.
+   */
+  listNoteRefs(account, folder) {
+    const folderRef = folder ? buildFolderReference(folder) : void 0;
+    const script = buildAccountScopedScript({ account }, this.buildBulkListCommand({ folderRef }));
+    const result = executeAppleScript(script);
+    if (!result.success) {
+      throw new Error(`Failed to list notes: ${result.error ?? "unknown error"}`);
+    }
+    return this.parseBulkListOutput(result.output);
   }
   /**
    * Lists all notes in an account, optionally filtered by folder, date, and limit.
@@ -40086,9 +40100,9 @@ var AppleNotesManager = class {
       const header = sepIdx === -1 ? result2.output : result2.output.slice(0, sepIdx);
       const totalCount = Number.parseInt(header.trim(), 10);
       const records = sepIdx === -1 ? "" : result2.output.slice(sepIdx + 1);
-      const titles = this.parseBulkListOutput(records, safeLimit);
-      if (!Number.isNaN(totalCount) && (titles.length >= safeLimit || totalCount <= safeLimit)) {
-        return titles;
+      const refs = this.parseBulkListOutput(records, safeLimit);
+      if (!Number.isNaN(totalCount) && (refs.length >= safeLimit || totalCount <= safeLimit)) {
+        return refs.map((ref) => ref.title);
       }
     }
     const script = buildAccountScopedScript(
@@ -40099,7 +40113,7 @@ var AppleNotesManager = class {
     if (!result.success) {
       throw new Error(`Failed to list notes: ${result.error ?? "unknown error"}`);
     }
-    return this.parseBulkListOutput(result.output, safeLimit);
+    return this.parseBulkListOutput(result.output, safeLimit).map((ref) => ref.title);
   }
   /**
    * Lists all shared (collaborative) notes across all accounts.
@@ -41416,13 +41430,14 @@ var AppleNotesManager = class {
           name: folder.name,
           notes: []
         };
-        const noteTitles = this.listNotes(account.name, folder.name);
-        for (const title of noteTitles) {
-          const note = this.getNoteDetails(title, account.name);
+        const noteRefs = this.listNoteRefs(account.name, folder.name);
+        for (const ref of noteRefs) {
+          const note = this.getNoteById(ref.id);
           if (!note) continue;
+          note.account = account.name;
           let content = "";
           if (!note.passwordProtected) {
-            content = this.getNoteContent(title, account.name);
+            content = this.getNoteContentById(ref.id);
           }
           folderData.notes.push(this.exportNote(note, content));
           exportData.summary.totalNotes++;
@@ -41871,6 +41886,14 @@ function describeSearchLimit(effectiveLimit, wasDefault, resultCount) {
   return { info, truncationNote };
 }
 
+// src/utils/searchScope.ts
+function describeSearchScope(searchContent, resultCount) {
+  if (searchContent || resultCount > 0) {
+    return "";
+  }
+  return "\n\n\u2139\uFE0F Only note titles were searched, so a term that appears in note bodies would not match. Retry with `searchContent: true` to search bodies instead.";
+}
+
 // src/tools/doctor.ts
 import { spawnSync } from "child_process";
 function runDoctor(manager) {
@@ -42191,8 +42214,9 @@ server.registerTool(
 
 ${syncWarnings.join(" ")}` : "";
     if (notes.length === 0) {
+      const scopeHint = describeSearchScope(searchContent, notes.length);
       return successResponse(
-        `No notes found matching "${query}" in ${searchType}${folderInfo}${dateInfo}${syncNote}`,
+        `No notes found matching "${query}" in ${searchType}${folderInfo}${dateInfo}${scopeHint}${syncNote}`,
         { notes: [], count: 0 }
       );
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-notes-mcp",
-  "version": "2.6.10",
+  "version": "2.6.12",
   "description": "MCP server for Apple Notes - create, search, update, and manage notes via Claude and other AI assistants",
   "type": "module",
   "main": "build/index.js",
@@ -89,6 +89,6 @@
     "format:check": "prettier --check src",
     "typecheck": "tsc --noEmit",
     "sync:skills": "node scripts/sync-skills.mjs",
-    "version": "node scripts/sync-plugin-version.mjs && git add .claude-plugin .agents/plugins codex .hermes-plugin .antigravity-plugin"
+    "version": "node scripts/sync-plugin-version.mjs && git add .claude-plugin .agents/plugins codex .antigravity-plugin"
   }
 }