apple-notes-mcp 2.6.16 → 2.7.1

package/README.md

@@ -181,7 +181,7 @@ Creates a new note in Apple Notes.
 | `content` | string | Yes | The body content of the note (do not repeat the title here) |
 | `tags` | string[] | No | Returned-only metadata — **NOT written to Notes.app**. Apple Notes tags can't be set via AppleScript, so values passed here are echoed back in the response but do not appear on the created note. Use inline `#hashtags` in `content` instead (Notes.app turns those into real tags) |
 | `folder` | string | No | Folder to create the note in. Supports nested paths like `"Work/Clients"`. **The folder must already exist** — create it first with [`create-folder`](#create-folder). Defaults to account root |
-| `account` | string | No | Account name (defaults to iCloud). Must be an account Notes.app already has configured — see [`list-accounts`](#list-accounts) |
+| `account` | string | No | Account name (defaults to Notes.app's default account; matched exactly or by a *unique* prefix — an ambiguous prefix is refused). Must be an account Notes.app already has configured — see [`list-accounts`](#list-accounts) |
 | `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 (tagged with inline hashtags):**
@@ -224,7 +224,7 @@ Searches for notes by title or content.
 |-----------|------|----------|-------------|
 | `query` | string | Yes | Text to search for |
 | `searchContent` | boolean | No | If `true`, searches note body; if `false` (default), searches titles only |
-| `account` | string | No | Account to search in (defaults to iCloud) |
+| `account` | string | No | Account to search in (defaults to Notes.app's default account; exact or unique-prefix match) |
 | `folder` | string | No | Limit search to a specific folder (supports nested paths like `"Work/Clients"`) |
 | `modifiedSince` | string | No | ISO 8601 date string to filter notes modified on or after this date (e.g., `"2025-01-01"`) |
 | `limit` | number | No | Maximum number of results to return. **Defaults to 50** — a broad query reads several properties per match via AppleScript (~200ms/note), so an unbounded search over hundreds of matches can exceed Notes' 30s timeout and return an error instead of results. Pass a higher value to see more; the applied limit (and whether it truncated the results) is disclosed in the response. |
@@ -266,7 +266,7 @@ Retrieves the full content of a specific note.
 |-----------|------|----------|-------------|
 | `id` | string | No | Note ID (preferred - more reliable than title) |
 | `title` | string | No | Note title (use `id` instead when available) |
-| `account` | string | No | Account containing the note (defaults to iCloud, ignored if `id` is provided) |
+| `account` | string | No | Account containing the note (defaults to Notes.app's default account; exact or unique-prefix match, ignored if `id` is provided) |
 
 **Note:** Either `id` or `title` must be provided. Using `id` is recommended as it's unique and avoids issues with duplicate titles.
 
@@ -309,7 +309,7 @@ Retrieves a note's body as plain text, with no HTML markup.
 |-----------|------|----------|-------------|
 | `id` | string | No | Note ID (preferred - more reliable than title) |
 | `title` | string | No | Note title (use `id` instead when available) |
-| `account` | string | No | Account containing the note (defaults to iCloud, ignored if `id` is provided) |
+| `account` | string | No | Account containing the note (defaults to Notes.app's default account; exact or unique-prefix match, ignored if `id` is provided) |
 
 **Note:** Either `id` or `title` must be provided. This reads the note's native `plaintext` property, so it skips the HTML-to-text conversion that `get-note-content` plus a Markdown pass would do. Use `get-note-content` when you need the HTML, or `get-note-markdown` when you want Markdown with checklist state.
 
@@ -324,7 +324,7 @@ Retrieves metadata about a note (without full content).
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `title` | string | Yes | Exact title of the note |
-| `account` | string | No | Account containing the note (defaults to iCloud) |
+| `account` | string | No | Account containing the note (defaults to Notes.app's default account; exact or unique-prefix match) |
 
 **Example:**
 ```json
@@ -383,7 +383,7 @@ Updates an existing note's content and/or title.
 | `title` | string | No | Current title of the note to update (use `id` instead when available) |
 | `newTitle` | string | No | New title (if changing the title; ignored when `format` is `"html"`) |
 | `newContent` | string | Yes | New content for the note body |
-| `account` | string | No | Account containing the note (defaults to iCloud, ignored if `id` is provided) |
+| `account` | string | No | Account containing the note (defaults to Notes.app's default account; exact or unique-prefix match, ignored if `id` is provided) |
 | `format` | string | No | Content format: `"plaintext"` (default) or `"html"`. When `"html"`, content replaces the entire note body as raw HTML and `newTitle` is ignored (the first HTML element serves as the title) |
 
 **Note:** Either `id` or `title` must be provided. Using `id` is recommended.
@@ -440,7 +440,7 @@ Deletes a note (moves to Recently Deleted in Notes.app).
 |-----------|------|----------|-------------|
 | `id` | string | No | Note ID (preferred - more reliable than title) |
 | `title` | string | No | Exact title of the note to delete (use `id` instead when available) |
-| `account` | string | No | Account containing the note (defaults to iCloud, ignored if `id` is provided) |
+| `account` | string | No | Account containing the note (defaults to Notes.app's default account; exact or unique-prefix match, ignored if `id` is provided) |
 
 **Note:** Either `id` or `title` must be provided. Using `id` is recommended.
 
@@ -473,7 +473,7 @@ Moves a note to a different folder. The note is relocated in place via Notes.app
 | `id` | string | No | Note ID (preferred - more reliable than title) |
 | `title` | string | No | Title of the note to move (use `id` instead when available) |
 | `folder` | string | Yes | Destination folder name or nested path (e.g., `"Work/Clients"`) |
-| `account` | string | No | Account containing the note (defaults to iCloud, ignored if `id` is provided) |
+| `account` | string | No | Account containing the note (defaults to Notes.app's default account; exact or unique-prefix match, ignored if `id` is provided) |
 
 **Note:** Either `id` or `title` must be provided. Using `id` is recommended.
 
@@ -509,7 +509,7 @@ Appends or prepends content to an existing note without replacing it. Always rea
 | `position` | string | No | `"after"` (default) appends to the end; `"before"` prepends to the start |
 | `separator` | string | No | String placed between existing content and new content (default: two newlines → `<div><br></div>` in HTML) |
 | `format` | string | No | Format of the content being appended: `"plaintext"` (default) or `"html"` |
-| `account` | string | No | Account containing the note (defaults to iCloud, ignored if `id` is provided) |
+| `account` | string | No | Account containing the note (defaults to Notes.app's default account; exact or unique-prefix match, ignored if `id` is provided) |
 
 **Note:** Either `id` or `title` must be provided. Using `id` is recommended.
 
@@ -545,7 +545,7 @@ Returns the `notes://showNote?identifier=<uuid>` deep-link URL for a note. The U
 |-----------|------|----------|-------------|
 | `id` | string | No | Note ID (preferred - more reliable than title) |
 | `title` | string | No | Note title (use `id` instead when available) |
-| `account` | string | No | Account containing the note (defaults to iCloud, ignored if `id` is provided) |
+| `account` | string | No | Account containing the note (defaults to Notes.app's default account; exact or unique-prefix match, ignored if `id` is provided) |
 
 **Note:** Either `id` or `title` must be provided. Using `id` is recommended. Password-protected notes cannot be linked.
 
@@ -568,7 +568,7 @@ Lists all notes, optionally filtered by folder, date, and limit.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `account` | string | No | Account to list notes from (defaults to iCloud) |
+| `account` | string | No | Account to list notes from (defaults to Notes.app's default account; exact or unique-prefix match) |
 | `folder` | string | No | Filter to notes in this folder only (supports nested paths like `"Work/Clients"`) |
 | `modifiedSince` | string | No | ISO 8601 date string to filter notes modified on or after this date (e.g., `"2025-01-01"`) |
 | `limit` | number | No | Maximum number of notes to return |
@@ -593,7 +593,11 @@ Lists all notes, optionally filtered by folder, date, and limit.
 }
 ```
 
-**Returns:** List of note titles.
+**Returns:** List of notes as `{title, id}` pairs — `notes: Array<{title, id}>`, plus `count`. The human-readable line is `  - <title> [id: <id>]`.
+
+Use the returned `id` for any follow-up read/update/move/delete rather than re-resolving the title: titles are not unique, and a by-title lookup resolves a duplicated title to the same one note every time, silently skipping the others.
+
+> **Changed in 2.7.0:** `notes` was previously `string[]` (titles only). Callers that treated the array as strings must now read `.title`.
 
 ---
 
@@ -615,7 +619,7 @@ Lists all folders in an account with full hierarchical paths.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `account` | string | No | Account to list folders from (defaults to iCloud) |
+| `account` | string | No | Account to list folders from (defaults to Notes.app's default account; exact or unique-prefix match) |
 
 **Example:**
 ```json
@@ -633,7 +637,7 @@ Creates a new folder, including a whole nested hierarchy in one call.
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `name` | string | Yes | Folder name, or a nested path separated by `/` (e.g. `"Retro Tech/PC/CPUs"`). Every intermediate folder is created; segments that already exist are skipped |
-| `account` | string | No | Account to create folder in (defaults to iCloud) |
+| `account` | string | No | Account to create folder in (defaults to Notes.app's default account; exact or unique-prefix match) |
 
 **Example:**
 ```json
@@ -660,7 +664,7 @@ Deletes a folder.
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `name` | string | Yes | Name or path of the folder to delete (supports nested paths like `"Work/Old"`) |
-| `account` | string | No | Account containing the folder (defaults to iCloud) |
+| `account` | string | No | Account containing the folder (defaults to Notes.app's default account; exact or unique-prefix match) |
 
 **Example:**
 ```json
@@ -959,7 +963,10 @@ AI: [calls get-note-content with title="Shopping List"]
 
 ### Working with Accounts
 
-By default, all operations use iCloud. To work with other accounts:
+Omit `account` and an operation targets whichever account **Notes.app itself
+reports as the default** — not a hardcoded "iCloud". That matters if your default
+is a non-iCloud account, if the account name is localized, or if it carries a
+trailing U+F8FF () character.
 
 ```
 User: "What accounts do I have?"
@@ -971,6 +978,23 @@ AI: [calls list-notes with account="Gmail"]
     "Your Gmail account has 5 notes..."
 ```
 
+When you do pass `account`, it is resolved in this order:
+
+1. **Exact name match** wins outright.
+2. A **unique prefix match** resolves — `account="robert"` finds
+   `robert.b.sweet@gmail.com`.
+3. An **ambiguous prefix is refused**, with every candidate named:
+
+   ```
+   Account "rob" is ambiguous - it matches 2 accounts:
+   rob@superiortech.io, robert.b.sweet@gmail.com. Use the full account name.
+   ```
+
+That third rule is deliberate. Silently taking the *first* prefix match would
+make `delete-note` or `move-note` land in the wrong account and report success.
+An unresolvable account is reported as such rather than as "note not found", so
+you are not sent looking for the wrong problem.
+
 ### Organizing with Folders
 
 ```

package/build/index.js

@@ -39407,11 +39407,47 @@ function buildFolderReference(folderPath) {
   }
   return parts.reverse().map((part) => `folder "${escapePlainStringForAppleScript(part)}"`).join(" of ");
 }
+var AS_ACCOUNT_REF = "__acctRef";
+var ACCOUNT_RESOLUTION_ERROR = "AccountResolutionError:";
+function throwIfAccountResolutionFailed(error2) {
+  if (!error2) return;
+  const at = error2.indexOf(ACCOUNT_RESOLUTION_ERROR);
+  if (at === -1) return;
+  throw new Error(error2.slice(at + ACCOUNT_RESOLUTION_ERROR.length).trim());
+}
+function buildAccountResolution(account) {
+  if (account === void 0) {
+    return `set ${AS_ACCOUNT_REF} to default account`;
+  }
+  const safeAccount = sanitizeAccountName(account);
+  return `
+    set ${AS_ACCOUNT_REF} to missing value
+    set _exactMatches to (every account whose name is "${safeAccount}")
+    if (count of _exactMatches) is 1 then
+      set ${AS_ACCOUNT_REF} to item 1 of _exactMatches
+    else
+      set _prefixMatches to (every account whose name starts with "${safeAccount}")
+      if (count of _prefixMatches) is 1 then
+        set ${AS_ACCOUNT_REF} to item 1 of _prefixMatches
+      else if (count of _prefixMatches) > 1 then
+        set _candidateNames to {}
+        repeat with _candidate in _prefixMatches
+          set end of _candidateNames to name of (contents of _candidate)
+        end repeat
+        set AppleScript's text item delimiters to ", "
+        set _joinedNames to _candidateNames as text
+        set AppleScript's text item delimiters to ""
+        error "${ACCOUNT_RESOLUTION_ERROR} Account \\"${safeAccount}\\" is ambiguous - it matches " & (count of _prefixMatches) & " accounts: " & _joinedNames & ". Use the full account name."
+      end if
+    end if
+    if ${AS_ACCOUNT_REF} is missing value then error "${ACCOUNT_RESOLUTION_ERROR} Account \\"${safeAccount}\\" not found"
+  `;
+}
 function buildAccountScopedScript(scope, command) {
-  const safeAccount = sanitizeAccountName(scope.account);
   return `
     tell application "Notes"
-      tell account "${safeAccount}"
+      ${buildAccountResolution(scope.account)}
+      tell ${AS_ACCOUNT_REF}
         ${command}
       end tell
     end tell
@@ -39452,16 +39488,48 @@ function extractCoreDataId(output, prefix) {
 }
 var AppleNotesManager = class {
   /**
-   * Default account used when no account is specified.
-   * iCloud is the primary account for most Apple Notes users.
+   * Normalizes a caller-supplied account name for the script builders.
+   *
+   * Returns `undefined` when no account was requested, which
+   * {@link buildAccountResolution} turns into Notes.app's own
+   * `default account`. It deliberately no longer substitutes a hardcoded
+   * `"iCloud"` — that name is wrong for anyone whose default account differs,
+   * is localized, or carries a U+F8FF suffix (#128).
    */
-  defaultAccount = "iCloud";
+  resolveAccount(account) {
+    const trimmed = account?.trim();
+    return trimmed ? trimmed : void 0;
+  }
   /**
-   * Resolves the account to use for an operation.
-   * Falls back to default if not specified.
+   * Cached name of Notes.app's default account, for payload reporting only.
+   * `null` = not yet queried; `""` = queried and unavailable (don't retry).
    */
-  resolveAccount(account) {
-    return account || this.defaultAccount;
+  defaultAccountName = null;
+  /**
+   * The account name to report back in a returned payload.
+   *
+   * Returns the caller's account verbatim when they named one. When they did
+   * not, it reports the *real* default account rather than the hardcoded
+   * "iCloud" the payloads used to claim (#128).
+   *
+   * Most scripts resolve the account inline via {@link buildAccountResolution}
+   * and cost nothing extra; this exists for the handful of methods whose script
+   * output can't carry the name back — notably `createNote`, whose nested-folder
+   * branch depends on the implicit result of `make new note` and must not have
+   * its return value extended (the -1728 workaround above).
+   *
+   * The lookup runs at most once per manager instance and is cached, including
+   * the failure case, so a Notes.app that can't answer is not re-asked on every
+   * call. Returns `undefined` when unknown — `account` is an optional field, and
+   * omitting it is honest where guessing was not.
+   */
+  reportedAccount(targetAccount) {
+    if (targetAccount !== void 0) return targetAccount;
+    if (this.defaultAccountName === null) {
+      const result = executeAppleScript(buildAppLevelScript("return name of default account"));
+      this.defaultAccountName = result.success ? result.output.trim() : "";
+    }
+    return this.defaultAccountName || void 0;
   }
   /**
    * Checks if a note is password-protected by its ID.
@@ -39481,7 +39549,7 @@ var AppleNotesManager = class {
    * Checks if a note is password-protected by its title.
    *
    * @param title - Exact title of the note
-   * @param account - Account to search in (defaults to iCloud)
+   * @param account - Account to search in (defaults to Notes.app's default account)
    * @returns true if the note is password-protected, false otherwise
    */
   isNotePasswordProtected(title, account) {
@@ -39502,7 +39570,7 @@ var AppleNotesManager = class {
    * @param content - Body content (plain text that will be HTML-escaped, or raw HTML when format is "html")
    * @param tags - Optional tags (stored in returned object, not used by Notes.app)
    * @param folder - Optional folder name to create the note in
-   * @param account - Account to use (defaults to iCloud)
+   * @param account - Account to use (defaults to Notes.app's default account)
    * @param format - Content format: "plaintext" escapes and wraps in div tags (default), "html" uses content as-is
    * @returns Created Note object with metadata, or null on failure
    *
@@ -39542,6 +39610,7 @@ var AppleNotesManager = class {
     const script = buildAccountScopedScript({ account: targetAccount }, createCommand);
     const result = executeMutationAppleScript(script);
     if (!result.success) {
+      throwIfAccountResolutionFailed(result.error);
       console.error(`Failed to create note "${title}":`, result.error);
       return null;
     }
@@ -39557,7 +39626,7 @@ var AppleNotesManager = class {
       created: now,
       modified: now,
       folder,
-      account: targetAccount
+      account: this.reportedAccount(targetAccount)
     };
   }
   /**
@@ -39568,7 +39637,7 @@ var AppleNotesManager = class {
    *
    * @param query - Text to search for
    * @param searchContent - If true, search note bodies; if false, search titles
-   * @param account - Account to search in (defaults to iCloud)
+   * @param account - Account to search in (defaults to Notes.app's default account)
    * @param folder - Optional folder to limit search to
    * @param modifiedSince - Optional ISO 8601 date string to filter notes modified on or after this date
    * @param limit - Optional maximum number of results to return (default: no limit)
@@ -39660,6 +39729,7 @@ var AppleNotesManager = class {
     const items = result.output.split(RECORD_SEP);
     const notes = [];
     const seenIds = /* @__PURE__ */ new Set();
+    const reportedAccount = this.reportedAccount(targetAccount);
     for (const item of items) {
       const [title, id, folder2, created, modified] = item.split(FIELD_SEP);
       if (!title?.trim()) continue;
@@ -39675,7 +39745,7 @@ var AppleNotesManager = class {
         created: parseAppleScriptDate(created ?? ""),
         modified: parseAppleScriptDate(modified ?? ""),
         folder: folder2?.trim(),
-        account: targetAccount
+        account: reportedAccount
       });
     }
     return notes;
@@ -39688,7 +39758,7 @@ var AppleNotesManager = class {
    * getNoteDetails() or isNotePasswordProtected().
    *
    * @param title - Exact title of the note
-   * @param account - Account to search in (defaults to iCloud)
+   * @param account - Account to search in (defaults to Notes.app's default account)
    * @returns HTML content of the note, or empty string if not found
    *
    * @example
@@ -39706,6 +39776,7 @@ var AppleNotesManager = class {
     const script = buildAccountScopedScript({ account: targetAccount }, getCommand);
     const result = executeAppleScript(script);
     if (!result.success) {
+      throwIfAccountResolutionFailed(result.error);
       console.error(`Failed to get content of note "${title}":`, result.error);
       return "";
     }
@@ -39744,7 +39815,7 @@ var AppleNotesManager = class {
    * round-trip entirely.
    *
    * @param title - Exact title of the note
-   * @param account - Account to search in (defaults to iCloud)
+   * @param account - Account to search in (defaults to Notes.app's default account)
    * @returns Plain-text content of the note, or empty string if not found
    */
   getNotePlaintext(title, account) {
@@ -39754,6 +39825,7 @@ var AppleNotesManager = class {
     const script = buildAccountScopedScript({ account: targetAccount }, getCommand);
     const result = executeAppleScript(script);
     if (!result.success) {
+      throwIfAccountResolutionFailed(result.error);
       console.error(`Failed to get plaintext of note "${title}":`, result.error);
       return "";
     }
@@ -39832,7 +39904,7 @@ var AppleNotesManager = class {
    * including creation date, modification date, and sharing status.
    *
    * @param title - Exact title of the note
-   * @param account - Account to search in (defaults to iCloud)
+   * @param account - Account to search in (defaults to Notes.app's default account)
    * @returns Note object with full metadata, or null if not found
    */
   getNoteDetails(title, account) {
@@ -39849,6 +39921,7 @@ var AppleNotesManager = class {
     const script = buildAccountScopedScript({ account: targetAccount }, getCommand);
     const result = executeAppleScript(script);
     if (!result.success) {
+      throwIfAccountResolutionFailed(result.error);
       console.error(`Failed to get details for note "${title}":`, result.error);
       return null;
     }
@@ -39866,7 +39939,7 @@ var AppleNotesManager = class {
       modified: parsed.modified,
       shared: parsed.shared,
       passwordProtected: parsed.passwordProtected,
-      account: targetAccount
+      account: this.reportedAccount(targetAccount)
     };
   }
   /**
@@ -39876,7 +39949,7 @@ var AppleNotesManager = class {
    * from the "Recently Deleted" folder in Notes.app.
    *
    * @param title - Exact title of the note to delete
-   * @param account - Account containing the note (defaults to iCloud)
+   * @param account - Account containing the note (defaults to Notes.app's default account)
    * @returns true if deletion succeeded, false otherwise
    */
   deleteNote(title, account) {
@@ -39886,6 +39959,7 @@ var AppleNotesManager = class {
     const script = buildAccountScopedScript({ account: targetAccount }, deleteCommand);
     const result = executeMutationAppleScript(script);
     if (!result.success) {
+      throwIfAccountResolutionFailed(result.error);
       console.error(`Failed to delete note "${title}":`, result.error);
       return false;
     }
@@ -39928,7 +40002,7 @@ var AppleNotesManager = class {
    * @param title - Current title of the note to update
    * @param newTitle - New title (optional, keeps existing if not provided; ignored in html format)
    * @param newContent - New content for the note body
-   * @param account - Account containing the note (defaults to iCloud)
+   * @param account - Account containing the note (defaults to Notes.app's default account)
    * @param format - Content format: "plaintext" wraps in div tags (default), "html" uses content as-is
    * @returns true if update succeeded, false otherwise
    */
@@ -39950,6 +40024,7 @@ var AppleNotesManager = class {
     const script = buildAccountScopedScript({ account: targetAccount }, updateCommand);
     const result = executeMutationAppleScript(script);
     if (!result.success) {
+      throwIfAccountResolutionFailed(result.error);
       console.error(`Failed to update note "${title}":`, result.error);
       return false;
     }
@@ -40100,29 +40175,12 @@ var AppleNotesManager = class {
     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.
+   * Core listing path shared by `listNotes()` and `listNoteRefs()`: lists
+   * notes in an account, optionally filtered by folder, date, and limit,
+   * returning (title, id) pairs. Kept private because both public callers
+   * need to apply their own return shape.
    */
-  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.
-   *
-   * @param account - Account to list notes from (defaults to iCloud)
-   * @param folder - Optional folder to filter by
-   * @param modifiedSince - Optional ISO 8601 date string to filter notes modified on or after this date
-   * @param limit - Optional maximum number of results to return (default: no limit)
-   * @returns Array of note titles
-   */
-  listNotes(account, folder, modifiedSince, limit) {
+  listNotesCore(account, folder, modifiedSince, limit) {
     const targetAccount = this.resolveAccount(account);
     const safeLimit = limit !== void 0 && limit > 0 ? Math.floor(limit) : void 0;
     const folderRef = folder ? buildFolderReference(folder) : void 0;
@@ -40148,7 +40206,7 @@ var AppleNotesManager = class {
       const records = sepIdx === -1 ? "" : result2.output.slice(sepIdx + 1);
       const refs = this.parseBulkListOutput(records, safeLimit);
       if (!Number.isNaN(totalCount) && (refs.length >= safeLimit || totalCount <= safeLimit)) {
-        return refs.map((ref) => ref.title);
+        return refs;
       }
     }
     const script = buildAccountScopedScript(
@@ -40159,7 +40217,33 @@ var AppleNotesManager = class {
     if (!result.success) {
       throw new Error(`Failed to list notes: ${result.error ?? "unknown error"}`);
     }
-    return this.parseBulkListOutput(result.output, safeLimit).map((ref) => ref.title);
+    return this.parseBulkListOutput(result.output, safeLimit);
+  }
+  /**
+   * Lists all notes in an account, optionally filtered by folder, date, and limit.
+   *
+   * @param account - Account to list notes from (defaults to Notes.app's default account)
+   * @param folder - Optional folder to filter by
+   * @param modifiedSince - Optional ISO 8601 date string to filter notes modified on or after this date
+   * @param limit - Optional maximum number of results to return (default: no limit)
+   * @returns Array of note titles
+   */
+  listNotes(account, folder, modifiedSince, limit) {
+    return this.listNotesCore(account, folder, modifiedSince, limit).map((ref) => ref.title);
+  }
+  /**
+   * Lists all notes in an account, optionally filtered by folder, date, and
+   * limit — same filtering semantics as `listNotes()`, but returns each
+   * note's id alongside its title. Prefer this over `listNotes()` when the
+   * caller needs to resolve notes by identity afterward: re-resolving by
+   * title is unsafe when titles are duplicated (AppleScript's `note "<name>"`
+   * specifier resolves ambiguously to the same one note every time — see
+   * the fix in exportNotesAsJson for the failure mode this avoids).
+   *
+   * @returns Array of { title, id } pairs, deduplicated by id
+   */
+  listNoteRefs(account, folder, modifiedSince, limit) {
+    return this.listNotesCore(account, folder, modifiedSince, limit);
   }
   /**
    * Lists all shared (collaborative) notes across all accounts.
@@ -40239,12 +40323,13 @@ var AppleNotesManager = class {
    * so that duplicate folder names (e.g., multiple "Archive" folders) are
    * distinguishable and can be used directly in other operations.
    *
-   * @param account - Account to list folders from (defaults to iCloud)
+   * @param account - Account to list folders from (defaults to Notes.app's default account)
    * @returns Array of Folder objects with path-based names
    */
   listFolders(account) {
     const targetAccount = this.resolveAccount(account);
     const listCommand = `
+      set acctName to name of it
       set folderList to {}
       set allFolders to every folder
       repeat with f in allFolders
@@ -40255,7 +40340,7 @@ var AppleNotesManager = class {
           set parentId to id of cRef
         end if
         set sharedFlag to shared of fRef as text
-        set end of folderList to (id of fRef) & ${AS_FIELD_SEP} & (name of fRef) & ${AS_FIELD_SEP} & parentId & ${AS_FIELD_SEP} & sharedFlag
+        set end of folderList to (id of fRef) & ${AS_FIELD_SEP} & (name of fRef) & ${AS_FIELD_SEP} & parentId & ${AS_FIELD_SEP} & sharedFlag & ${AS_FIELD_SEP} & acctName
       end repeat
       set AppleScript's text item delimiters to ${AS_RECORD_SEP}
       return folderList as text
@@ -40275,7 +40360,11 @@ var AppleNotesManager = class {
         id: (parts[0] || "").trim(),
         name: (parts[1] || "").trim(),
         parentId: (parts[2] || "").trim(),
-        shared: (parts[3] || "").trim().toLowerCase() === "true"
+        shared: (parts[3] || "").trim().toLowerCase() === "true",
+        // The account name as Notes.app actually reports it. When the caller
+        // omitted `account` this is the resolved default, which is the whole
+        // point — reporting a hardcoded "iCloud" here was the #128 bug.
+        account: (parts[4] || "").trim()
       };
     });
     const byId = new Map(entries.map((e) => [e.id, e]));
@@ -40291,7 +40380,7 @@ var AppleNotesManager = class {
     return entries.map((entry) => ({
       id: entry.id,
       name: buildPath(entry),
-      account: targetAccount,
+      account: entry.account || targetAccount || "",
       shared: entry.shared
     }));
   }
@@ -40299,7 +40388,7 @@ var AppleNotesManager = class {
    * Creates a new folder in an account.
    *
    * @param name - Name for the new folder
-   * @param account - Account to create folder in (defaults to iCloud)
+   * @param account - Account to create folder in (defaults to Notes.app's default account)
    * @returns Created Folder object, or null on failure
    */
   createFolder(name, account) {
@@ -40332,6 +40421,7 @@ var AppleNotesManager = class {
       const script = buildAccountScopedScript({ account: targetAccount }, createCommand);
       const result = executeMutationAppleScript(script);
       if (!result.success) {
+        throwIfAccountResolutionFailed(result.error);
         console.error(`Failed to create folder "${name}":`, result.error);
         return null;
       }
@@ -40339,14 +40429,15 @@ var AppleNotesManager = class {
     const fullRef = buildFolderReference(name);
     const idScript = buildAccountScopedScript(
       { account: targetAccount },
-      `return id of ${fullRef}`
+      `return (id of ${fullRef}) & ${AS_FIELD_SEP} & (name of it)`
     );
     const idResult = executeAppleScript(idScript);
-    const folderId = idResult.success ? extractCoreDataId(idResult.output, "folder") : "";
+    const [rawId = "", rawAccount = ""] = idResult.success ? idResult.output.split(FIELD_SEP) : [];
+    const folderId = idResult.success ? extractCoreDataId(rawId, "folder") : "";
     return {
       id: folderId,
       name,
-      account: targetAccount
+      account: rawAccount.trim() || targetAccount || ""
     };
   }
   /**
@@ -40355,7 +40446,7 @@ var AppleNotesManager = class {
    * Note: This may fail if the folder contains notes.
    *
    * @param name - Name of the folder to delete
-   * @param account - Account containing the folder (defaults to iCloud)
+   * @param account - Account containing the folder (defaults to Notes.app's default account)
    * @returns true if deletion succeeded, false otherwise
    */
   deleteFolder(name, account) {
@@ -40364,6 +40455,7 @@ var AppleNotesManager = class {
     const script = buildAccountScopedScript({ account: targetAccount }, deleteCommand);
     const result = executeMutationAppleScript(script);
     if (!result.success) {
+      throwIfAccountResolutionFailed(result.error);
       console.error(`Failed to delete folder "${name}":`, result.error);
       return false;
     }
@@ -40383,7 +40475,7 @@ var AppleNotesManager = class {
    *
    * @param title - Title of the note to move
    * @param destinationFolder - Name of the folder to move to (must already exist)
-   * @param account - Account containing the note (defaults to iCloud)
+   * @param account - Account containing the note (defaults to Notes.app's default account)
    * @returns true if the move succeeded, false otherwise
    */
   moveNote(title, destinationFolder, account) {
@@ -40405,15 +40497,15 @@ var AppleNotesManager = class {
    *
    * @param id - CoreData URL identifier for the note
    * @param destinationFolder - Name of the folder to move to (must already exist)
-   * @param account - Account containing the destination folder (defaults to iCloud)
+   * @param account - Account containing the destination folder (defaults to Notes.app's default account)
    * @returns true if the move succeeded, false otherwise
    */
   moveNoteById(id, destinationFolder, account) {
     const targetAccount = this.resolveAccount(account);
     const safeId = sanitizeId(id);
-    const safeAccount = sanitizeAccountName(targetAccount);
-    const destFolderRef = `${buildFolderReference(destinationFolder)} of account "${safeAccount}"`;
+    const destFolderRef = `${buildFolderReference(destinationFolder)} of ${AS_ACCOUNT_REF}`;
     const moveCommand = `
+      ${buildAccountResolution(targetAccount)}
       set destFolder to ${destFolderRef}
       set noteRef to note id "${safeId}"
       move noteRef to destFolder
@@ -40421,6 +40513,7 @@ var AppleNotesManager = class {
     const script = buildAppLevelScript(moveCommand);
     const result = executeMutationAppleScript(script);
     if (!result.success) {
+      throwIfAccountResolutionFailed(result.error);
       console.error(
         `Cannot move note to "${destinationFolder}" (folder may not exist):`,
         result.error
@@ -40616,7 +40709,7 @@ var AppleNotesManager = class {
    * Returns the notes:// deep-link URL for a note by title.
    *
    * @param title - Exact note title
-   * @param account - Account to search in (defaults to iCloud)
+   * @param account - Account to search in (defaults to Notes.app's default account)
    * @returns notes://showNote?identifier=<uuid> string, or null on failure
    */
   getNoteLink(title, account) {
@@ -40790,12 +40883,11 @@ var AppleNotesManager = class {
       });
       return { healthy: false, checks };
     }
-    const defaultAccount = accounts[0]?.name || "iCloud";
-    const notes = this.listNotes(defaultAccount);
+    const notes = this.listNotes();
     checks.push({
       name: "operations",
       passed: true,
-      message: `Basic operations working (${notes.length} note(s) in ${defaultAccount})`
+      message: `Basic operations working (${notes.length} note(s) in the default account)`
     });
     const allPassed = checks.every((c) => c.passed);
     return { healthy: allPassed, checks };
@@ -41017,18 +41109,18 @@ var AppleNotesManager = class {
    * Lists attachments for a note by its title.
    *
    * @param title - Title of the note
-   * @param account - Account containing the note (defaults to iCloud)
+   * @param account - Account containing the note (defaults to Notes.app's default account)
    * @returns Array of Attachment objects, or empty array if the note genuinely has none
    * @throws If the AppleScript call fails, so a lookup failure is never mistaken for
    *   an attachment-free note (callers gate destructive full-body updates on this)
    */
   listAttachments(title, account) {
     const targetAccount = this.resolveAccount(account);
-    const safeAccount = escapePlainStringForAppleScript(targetAccount);
     const safeTitle = escapePlainStringForAppleScript(title);
     const script = `
       tell application "Notes"
-        tell account "${safeAccount}"
+        ${buildAccountResolution(targetAccount)}
+        tell ${AS_ACCOUNT_REF}
           set theNote to note "${safeTitle}"
         set attachmentList to {}
         set attachmentIds to id of every attachment of theNote
@@ -41328,7 +41420,7 @@ var AppleNotesManager = class {
    *
    * @param ids - Array of CoreData URL identifiers for notes to move
    * @param folder - Destination folder name
-   * @param account - Account containing the folder (defaults to iCloud)
+   * @param account - Account containing the folder (defaults to Notes.app's default account)
    * @returns Array of results with id, success status, and optional error message
    *
    * @example
@@ -41342,8 +41434,7 @@ var AppleNotesManager = class {
   batchMoveNotes(ids, folder, account) {
     if (ids.length === 0) return [];
     const targetAccount = this.resolveAccount(account);
-    const safeAccount = sanitizeAccountName(targetAccount);
-    const destFolderRef = `${buildFolderReference(folder)} of account "${safeAccount}"`;
+    const destFolderRef = `${buildFolderReference(folder)} of ${AS_ACCOUNT_REF}`;
     const results = new Array(ids.length);
     const runnable = [];
     ids.forEach((id, i) => {
@@ -41360,6 +41451,7 @@ var AppleNotesManager = class {
     if (runnable.length > 0) {
       const idList = runnable.map((r) => `"${r.safe}"`).join(", ");
       const script = buildAppLevelScript(`
+        ${buildAccountResolution(targetAccount)}
         set destFolder to ${destFolderRef}
         set out to ""
         repeat with rawId in {${idList}}
@@ -41391,6 +41483,7 @@ var AppleNotesManager = class {
       `);
       const res = executeMutationAppleScript(script);
       if (!res.success) {
+        throwIfAccountResolutionFailed(res.error);
         for (const r of runnable) {
           results[r.index] = this.createBatchResult(
             ids[r.index],
@@ -41571,7 +41664,7 @@ var AppleNotesManager = class {
    * [x] (done) or [ ] (undone) prefixes.
    *
    * @param title - Exact title of the note
-   * @param account - Account containing the note (defaults to iCloud)
+   * @param account - Account containing the note (defaults to Notes.app's default account)
    * @returns Markdown content, or empty string if not found
    *
    * @example
@@ -42162,11 +42255,15 @@ var MAX = {
 };
 var noteTitleSchema = {
   title: external_exports.string().min(1, "Note title is required").max(MAX.TITLE),
-  account: external_exports.string().max(MAX.ACCOUNT).optional().describe("Account name (defaults to iCloud)")
+  account: external_exports.string().max(MAX.ACCOUNT).optional().describe(
+    "Account name (defaults to Notes.app's default account; exact or unique-prefix match)"
+  )
 };
 var folderNameSchema = {
   name: external_exports.string().min(1, "Folder name is required").max(MAX.FOLDER),
-  account: external_exports.string().max(MAX.ACCOUNT).optional().describe("Account name (defaults to iCloud)")
+  account: external_exports.string().max(MAX.ACCOUNT).optional().describe(
+    "Account name (defaults to Notes.app's default account; exact or unique-prefix match)"
+  )
 };
 function registerTool(name, config2, cb) {
   const { outputSchema, ...rest } = config2;
@@ -42193,7 +42290,7 @@ registerTool(
         "Folder to create the note in (supports nested paths like 'Work/Clients'). The folder must already exist \u2014 this tool does not create it; call create-folder first, which is idempotent and creates intermediate segments."
       ),
       account: external_exports.string().max(MAX.ACCOUNT).optional().describe(
-        "Account name (defaults to iCloud). Must be an account Notes.app already has configured \u2014 see list-accounts."
+        "Account name (defaults to the account Notes.app itself reports as default). Matched exactly, or by a unique prefix; an ambiguous prefix is refused. Must be an account Notes.app already has configured \u2014 see list-accounts."
       )
     },
     outputSchema: {
@@ -42302,7 +42399,9 @@ registerTool(
     inputSchema: {
       id: external_exports.string().max(MAX.ID).optional().describe("Note ID (preferred - more reliable than title)"),
       title: external_exports.string().max(MAX.TITLE).optional().describe("Note title (use id instead when available)"),
-      account: external_exports.string().max(MAX.ACCOUNT).optional().describe("Account name (defaults to iCloud, ignored if id is provided)")
+      account: external_exports.string().max(MAX.ACCOUNT).optional().describe(
+        "Account name (defaults to Notes.app's default account; exact or unique-prefix match, ignored if id is provided)"
+      )
     },
     outputSchema: {
       title: external_exports.string().optional(),
@@ -42377,7 +42476,9 @@ registerTool(
     inputSchema: {
       id: external_exports.string().max(MAX.ID).optional().describe("Note ID (preferred - more reliable than title)"),
       title: external_exports.string().max(MAX.TITLE).optional().describe("Note title (use id instead when available)"),
-      account: external_exports.string().max(MAX.ACCOUNT).optional().describe("Account name (defaults to iCloud, ignored if id is provided)")
+      account: external_exports.string().max(MAX.ACCOUNT).optional().describe(
+        "Account name (defaults to Notes.app's default account; exact or unique-prefix match, ignored if id is provided)"
+      )
     },
     outputSchema: {
       title: external_exports.string().optional(),
@@ -42800,7 +42901,9 @@ registerTool(
     inputSchema: {
       id: external_exports.string().max(MAX.ID).optional().describe("Note ID (preferred - more reliable than title)"),
       title: external_exports.string().max(MAX.TITLE).optional().describe("Note title (use id instead when available)"),
-      account: external_exports.string().max(MAX.ACCOUNT).optional().describe("Account name (defaults to iCloud, ignored if id is provided)")
+      account: external_exports.string().max(MAX.ACCOUNT).optional().describe(
+        "Account name (defaults to Notes.app's default account; exact or unique-prefix match, ignored if id is provided)"
+      )
     },
     outputSchema: {
       ok: external_exports.boolean().optional(),
@@ -42909,7 +43012,7 @@ registerTool(
 registerTool(
   "list-notes",
   {
-    description: "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.",
+    description: "Use when: enumerating notes in an account or folder; supports modifiedSince and limit for large collections.\nReturns: each note's title and id (ids are safe to use for follow-up reads/edits even when titles are duplicated \u2014 see search-notes for keyword-based lookup instead).\nDo not use when: you need content (get-note-content).\nNote: warns if iCloud sync is active and results may be partial.",
     inputSchema: {
       account: external_exports.string().max(MAX.ACCOUNT).optional().describe("Account to list notes from"),
       folder: external_exports.string().max(MAX.FOLDER).optional().describe("Filter to specific folder"),
@@ -42919,7 +43022,7 @@ registerTool(
       limit: external_exports.number().int().positive().optional().describe("Maximum number of notes to return")
     },
     outputSchema: {
-      notes: external_exports.array(external_exports.string()).optional(),
+      notes: external_exports.array(external_exports.object({ title: external_exports.string(), id: external_exports.string() })).optional(),
       count: external_exports.number().optional()
     }
   },
@@ -42930,7 +43033,7 @@ registerTool(
       syncInterference
     } = withSyncAwarenessSync(
       "list-notes",
-      () => notesManager.listNotes(account, folder, modifiedSince, limit)
+      () => notesManager.listNoteRefs(account, folder, modifiedSince, limit)
     );
     const location = folder ? ` in folder "${folder}"` : "";
     const acct = account ? ` (${account})` : "";
@@ -42952,7 +43055,7 @@ ${syncWarnings.join(" ")}` : "";
         count: 0
       });
     }
-    const noteList = notes.map((t) => `  - ${t}`).join("\n");
+    const noteList = notes.map((n) => `  - ${n.title} [id: ${n.id}]`).join("\n");
     return successResponse(
       `Found ${notes.length} notes${location}${acct}${dateInfo}${limitInfo}:
 ${noteList}${syncNote}`,
@@ -43015,12 +43118,16 @@ ${syncWarnings.join(" ")}` : "";
     if (folders.length === 0) {
       return successResponse(`No folders found${acct}${syncNote}`, { folders: [], count: 0 });
     }
+    const resolvedAcct = folders[0]?.account ? ` (${folders[0].account})` : acct;
     const folderList = folders.map((f) => `  - ${f.name}`).join("\n");
-    return successResponse(`Found ${folders.length} folders${acct}:
-${folderList}${syncNote}`, {
-      folders,
-      count: folders.length
-    });
+    return successResponse(
+      `Found ${folders.length} folders${resolvedAcct}:
+${folderList}${syncNote}`,
+      {
+        folders,
+        count: folders.length
+      }
+    );
   }, "Error listing folders")
 );
 registerTool(
@@ -43031,7 +43138,9 @@ registerTool(
       name: external_exports.string().min(1, "Folder name is required").max(MAX.FOLDER).describe(
         'Folder name or nested path separated by "/". E.g., "Retro Tech/PC/CPUs" creates all intermediate folders. Existing segments are skipped.'
       ),
-      account: external_exports.string().max(MAX.ACCOUNT).optional().describe("Account name (defaults to iCloud)")
+      account: external_exports.string().max(MAX.ACCOUNT).optional().describe(
+        "Account name (defaults to Notes.app's default account; exact or unique-prefix match)"
+      )
     },
     outputSchema: {
       ok: external_exports.boolean().optional(),
@@ -43374,7 +43483,9 @@ registerTool(
       folder: external_exports.string().max(MAX.FOLDER).describe(
         'Destination folder name or nested path (e.g. "Work/Clients"). Must already exist \u2014 create-folder first.'
       ),
-      account: external_exports.string().max(MAX.ACCOUNT).optional().describe("Account containing the destination folder (defaults to iCloud)")
+      account: external_exports.string().max(MAX.ACCOUNT).optional().describe(
+        "Account containing the destination folder (defaults to Notes.app's default account; exact or unique-prefix match)"
+      )
     },
     outputSchema: {
       ok: external_exports.boolean().optional(),

package/package.json

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