apple-notes-mcp 2.1.3 → 2.2.0

package/README.md

@@ -62,7 +62,10 @@ The Codex plugin runs the published `apple-notes-mcp` server through `npx` and s
 
 ### Other Hosts (Hermes, Antigravity)
 
-Plugin packaging for the Hermes and Antigravity hosts is also included (`.hermes-plugin/` and `.antigravity-plugin/`). Each registers the same `apple-notes` MCP server (launched via `npx -y apple-notes-mcp`) and bundles the Apple Notes skill, so behavior matches the Claude Code and Codex plugins. Install them through each host's plugin/marketplace mechanism pointed at this repository.
+Configuration for two more hosts is included — each registers 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`](.hermes-plugin/config.yaml) into `~/.hermes/config.yaml`. Details: [`.hermes-plugin/README.md`](.hermes-plugin/README.md).
+- **[Antigravity](https://antigravity.google/)** (Google) — add the server entry from [`.antigravity-plugin/mcp_config.json`](.antigravity-plugin/mcp_config.json) to `~/.gemini/config/mcp_config.json` (or via Antigravity's MCP settings).
 
 ### Manual Installation
 

package/build/index.js

@@ -131,7 +131,13 @@ server.tool("create-note", "Use when: the user wants to create a brand-new Apple
         return errorResponse(`Failed to create note "${title}". Check that Notes.app is configured and accessible.`);
     }
     const checklistWarning = detectChecklistAttempt(content) ?? "";
-    return successResponse(`Note created: "${note.title}" [id: ${note.id}]${checklistWarning}`);
+    return successResponse(`Note created: "${note.title}" [id: ${note.id}]${checklistWarning}`, {
+        ok: true,
+        id: note.id,
+        title: note.title,
+        folder,
+        account,
+    });
 }, "Error creating note"));
 // --- search-notes ---
 server.tool("search-notes", "Use when: finding notes by a keyword in the title (or body with searchContent=true) and you need their ids.\nReturns: matching notes with title, folder, and id.\nDo not use when: you already have a note id (use get-note-content) or want every note (use list-notes).\nPrefer this first to obtain ids for subsequent read/update/delete/move calls.", {
@@ -313,7 +319,12 @@ server.tool("update-note", "Use when: changing the title and/or replacing the bo
             ? "\n\n⚠️ This note is shared with collaborators. Your changes will be visible to them."
             : "";
         const checklistWarning = detectChecklistAttempt(newContent) ?? "";
-        return successResponse(`Note updated: "${displayTitle}"${sharedWarning}${checklistWarning}`);
+        return successResponse(`Note updated: "${displayTitle}"${sharedWarning}${checklistWarning}`, {
+            ok: true,
+            id,
+            title: displayTitle,
+            shared: note.shared ?? false,
+        });
     }
     // Fall back to title-based update
     if (!title) {
@@ -337,7 +348,11 @@ server.tool("update-note", "Use when: changing the title and/or replacing the bo
         ? "\n\n⚠️ This note is shared with collaborators. Your changes will be visible to them."
         : "";
     const checklistWarning = detectChecklistAttempt(newContent) ?? "";
-    return successResponse(`Note updated: "${finalTitle}"${sharedWarning}${checklistWarning}`);
+    return successResponse(`Note updated: "${finalTitle}"${sharedWarning}${checklistWarning}`, {
+        ok: true,
+        title: finalTitle,
+        shared: note.shared ?? false,
+    });
 }, "Error updating note"));
 // --- delete-note ---
 server.tool("delete-note", "Use when: permanently deleting a single note, by id (preferred) or title.\nReturns: confirmation; warns when the note was shared.\nDo not use when: deleting many notes (batch-delete-notes) or just relocating one (move-note).\nSafety: requires explicit user confirmation before deleting. Prefer search-notes/list-notes first to show the affected note id and title. Deleting a shared note removes collaborator access.", {
@@ -363,7 +378,12 @@ server.tool("delete-note", "Use when: permanently deleting a single note, by id
         const sharedWarning = note.shared
             ? "\n\n⚠️ This note was shared with collaborators. They will no longer have access."
             : "";
-        return successResponse(`Note deleted: "${note.title}"${sharedWarning}`);
+        return successResponse(`Note deleted: "${note.title}"${sharedWarning}`, {
+            ok: true,
+            id,
+            title: note.title,
+            wasShared: note.shared ?? false,
+        });
     }
     // Fall back to title-based deletion
     if (!title) {
@@ -382,7 +402,11 @@ server.tool("delete-note", "Use when: permanently deleting a single note, by id
     const sharedWarning = note.shared
         ? "\n\n⚠️ This note was shared with collaborators. They will no longer have access."
         : "";
-    return successResponse(`Note deleted: "${title}"${sharedWarning}`);
+    return successResponse(`Note deleted: "${title}"${sharedWarning}`, {
+        ok: true,
+        title,
+        wasShared: note.shared ?? false,
+    });
 }, "Error deleting note"));
 // --- move-note ---
 server.tool("move-note", "Use when: moving one note to a different folder, by id (preferred) or title.\nReturns: confirmation of the note and destination folder.\nDo not use when: moving many notes (batch-move-notes).\nNote: implemented as copy-then-delete; the destination folder must already exist (create-folder).", {
@@ -402,7 +426,12 @@ server.tool("move-note", "Use when: moving one note to a different folder, by id
         if (!success) {
             return errorResponse(`Failed to move note "${note.title}" to folder "${folder}". Folder may not exist.`);
         }
-        return successResponse(`Note moved: "${note.title}" -> "${folder}"`);
+        return successResponse(`Note moved: "${note.title}" -> "${folder}"`, {
+            ok: true,
+            id,
+            title: note.title,
+            folder,
+        });
     }
     // Fall back to title-based move
     if (!title) {
@@ -417,7 +446,11 @@ server.tool("move-note", "Use when: moving one note to a different folder, by id
     if (!success) {
         return errorResponse(`Failed to move note "${title}" to folder "${folder}". Folder may not exist.`);
     }
-    return successResponse(`Note moved: "${title}" -> "${folder}"`);
+    return successResponse(`Note moved: "${title}" -> "${folder}"`, {
+        ok: true,
+        title,
+        folder,
+    });
 }, "Error moving note"));
 // --- list-notes ---
 server.tool("list-notes", "Use when: enumerating notes in an account or folder; supports modifiedSince and limit for large collections.\nReturns: note titles only (no content or ids).\nDo not use when: you need content (get-note-content) or ids for follow-up edits (use search-notes).\nNote: warns if iCloud sync is active and results may be partial.", {
@@ -506,7 +539,10 @@ server.tool("create-folder", "Use when: creating a folder, including nested path
     if (!folder) {
         return errorResponse(`Failed to create folder "${name}".`);
     }
-    return successResponse(`Folder created: "${folder.name}"`);
+    return successResponse(`Folder created: "${folder.name}"`, {
+        ok: true,
+        folder: folder.name,
+    });
 }, "Error creating folder"));
 // --- delete-folder ---
 server.tool("delete-folder", "Use when: deleting an existing folder by name or nested path.\nReturns: confirmation.\nDo not use when: deleting a note (delete-note).\nSafety: requires explicit user confirmation. Deletion fails if the folder still contains notes — list or move those notes first.", folderNameSchema, withErrorHandling(({ name, account }) => {
@@ -514,7 +550,7 @@ server.tool("delete-folder", "Use when: deleting an existing folder by name or n
     if (!success) {
         return errorResponse(`Failed to delete folder "${name}". Folder may not exist or may contain notes.`);
     }
-    return successResponse(`Folder deleted: "${name}"`);
+    return successResponse(`Folder deleted: "${name}"`, { ok: true, folder: name });
 }, "Error deleting folder"));
 // =============================================================================
 // Account Tools
@@ -607,7 +643,11 @@ server.tool("health-check", "Use when: a quick check that Notes.app is reachable
     const fdaLine = fdaAvailable
         ? "  ✓ full_disk_access: Granted (checklist features available)"
         : "  ⓘ full_disk_access: Not granted (optional — needed for get-checklist-state and checklist annotations in get-note-markdown). Grant in System Settings > Privacy & Security > Full Disk Access.";
-    return successResponse(`${statusIcon} ${statusText}\n\n${checkLines}\n${fdaLine}`);
+    return successResponse(`${statusIcon} ${statusText}\n\n${checkLines}\n${fdaLine}`, {
+        healthy: result.healthy,
+        checks: result.checks,
+        fullDiskAccess: fdaAvailable,
+    });
 }, "Error running health check"));
 // --- doctor ---
 server.tool("doctor", "Use when: diagnosing setup problems (Notes.app automation permission, account state, Full Disk Access) with actionable guidance.\nReturns: a detailed report plus structured fields.\nDo not use when: you just need a quick pass/fail (health-check).\nRead-only.", {}, withErrorHandling(() => {
@@ -709,7 +749,14 @@ server.tool("batch-delete-notes", "Use when: permanently deleting multiple notes
             lines.push(`  - ${result.id}: ${result.error}`);
         }
     }
-    return succeeded > 0 ? successResponse(lines.join("\n")) : errorResponse(lines.join("\n"));
+    return succeeded > 0
+        ? successResponse(lines.join("\n"), {
+            ok: failed === 0,
+            succeeded,
+            failed,
+            results,
+        })
+        : errorResponse(lines.join("\n"));
 }, "Error performing batch delete"));
 // --- batch-move-notes ---
 server.tool("batch-move-notes", "Use when: moving multiple notes by id into one destination folder.\nReturns: per-id success/failure counts.\nDo not use when: moving a single note (move-note).\nNote: the destination folder must already exist (create-folder).", {
@@ -733,7 +780,15 @@ server.tool("batch-move-notes", "Use when: moving multiple notes by id into one
             lines.push(`  - ${result.id}: ${result.error}`);
         }
     }
-    return succeeded > 0 ? successResponse(lines.join("\n")) : errorResponse(lines.join("\n"));
+    return succeeded > 0
+        ? successResponse(lines.join("\n"), {
+            ok: failed === 0,
+            folder,
+            succeeded,
+            failed,
+            results,
+        })
+        : errorResponse(lines.join("\n"));
 }, "Error performing batch move"));
 // --- save-attachment ---
 server.tool("save-attachment", "Use when: writing one note attachment to a file on disk.\nReturns: the saved path.\nDo not use when: you want the bytes in-memory as base64 (fetch-attachment).\nSafety: writes a file; savePath must be absolute and under the home directory, a temp dir, or /Volumes. Get the ids from list-attachments first.", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-notes-mcp",
-  "version": "2.1.3",
+  "version": "2.2.0",
   "description": "MCP server for Apple Notes - create, search, update, and manage notes via Claude and other AI assistants",
   "type": "module",
   "main": "build/index.js",
@@ -59,7 +59,7 @@
     "darwin"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.4.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "turndown": "^7.2.2",
     "zod": "^3.22.4"
   },