apple-notes-mcp 2.8.29 → 2.8.30

package/README.md

@@ -56,7 +56,7 @@ Install as a Claude Code plugin for automatic configuration and enhanced AI beha
 
 This method also installs a **skill** that teaches Claude when and how to use Apple Notes effectively.
 
-On the first tool call, macOS shows an Automation permission prompt ("Claude" wants access to control "Notes") — click **OK**. Optionally, grant **Full Disk Access** to the app that launches the server to enable the database-backed tools (`get-checklist-state`, `get-note-metadata`, `get-note-link`, checklist annotations in `get-note-markdown`, and full `get-sync-status` detail); see the [Full Disk Access Setup Guide](https://github.com/sweetrb/apple-notes-mcp/blob/main/docs/FULL-DISK-ACCESS.md). The rest of the server is pure AppleScript and works without it.
+On the first tool call, macOS shows an Automation permission prompt ("Claude" wants access to control "Notes") — click **OK**. Optionally, grant **Full Disk Access** to the app that launches the server to enable the database-backed tools (`get-checklist-state`, `get-note-metadata`, `get-audio-transcripts`, `get-note-link`, checklist annotations in `get-note-markdown`, and full `get-sync-status` detail); see the [Full Disk Access Setup Guide](https://github.com/sweetrb/apple-notes-mcp/blob/main/docs/FULL-DISK-ACCESS.md). The rest of the server is pure AppleScript and works without it.
 
 Native tag, checklist, table, pin, and rich append operations use two packaged
 Apple Shortcuts. A third, `Apple Notes MCP - Create Markdown Note`, is optional:
@@ -169,6 +169,7 @@ On first use, macOS will ask for permission to automate Notes.app. Click "OK" to
 | **Multi-Account** | Work with iCloud, Gmail, Exchange, or any configured account, including account IDs and default folders |
 | **Batch Operations** | Delete or move multiple notes at once |
 | **Checklist State** | Read checklist done/undone state directly from the Notes database (requires Full Disk Access) |
+| **Audio Transcripts** | Read the transcripts and summaries Notes stored for audio recordings (requires Full Disk Access) |
 | **Export** | Export all notes as JSON or get individual notes as Markdown |
 | **Attachments** | List attachments, save them to disk, or fetch their bytes as base64 |
 | **Notes.app UI State** | Reveal a note in Notes.app or read the current Notes.app selection |
@@ -1274,6 +1275,38 @@ Reads note metadata that AppleScript cannot expose, by querying the NoteStore SQ
 
 ---
 
+#### `get-audio-transcripts`
+
+Reads the transcript, and the summary when one exists, that Notes already computed for the audio recordings in a note. It does not transcribe anything itself. Notes keeps each recording's transcript as word-level mergeable data on the audio attachment's database row, and this tool decodes it read-only.
+
+**Requires:** Full Disk Access for the MCP host process (see [Full Disk Access Setup](#full-disk-access)). Password-protected notes are refused.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | Yes | Note ID (use `search-notes` to find it first) |
+| `includeSegments` | boolean | No | Also return word-level segments: `text`, `start` and `duration` in seconds, and `speaker`. Default `false` |
+| `maxSegments` | number | No | Cap on segments per attachment when `includeSegments` is set (default 2000, at most 20000) |
+
+**Example:**
+```json
+{
+  "id": "x-coredata://ABC123/ICNote/p456",
+  "includeSegments": true,
+  "maxSegments": 500
+}
+```
+
+**Returns:** `structuredContent.attachments` holds one entry per top-level audio attachment, in the order the recordings appear in the note. Each entry has:
+
+- `attachmentId` (usable with `save-attachment`), `identifier`, `typeUti`, and `durationSeconds` when known
+- `status`: `ok` (a transcript is stored), `none` (no transcript is stored, for example a recording Notes has not transcribed, or an audio file attached from elsewhere), or `undecodable` with a `reason`
+- `text` (the words joined into readable text), `wordCount`, `fragmentCount`, `speakers`, `summary` and `topLineSummary` when stored, and `needsTranscription` when the database records it
+- `segments`, only when `includeSegments` is set, with `segmentsTruncated` when the cap cut them short
+
+A recording extended with more takes has several fragments. Their transcripts are joined in stored order, separated by a blank line, and each segment carries a `fragment` index. Recordings with more than one fragment have been verified against synthetic fixtures only. A response that would exceed `APPLE_NOTES_MCP_EXPORT_MAX_BYTES` (default 8 MB) drops segments first and then shortens `text`, marking `truncated`, `segmentsTruncated` and `textTruncated`. When the note body cannot be parsed, attachments come back in database order with `bodyOrder: false`.
+
+---
+
 #### `add-attachment`
 
 Adds one nonempty local file of at most 64 MiB to an exact note using `id`, the
@@ -1691,7 +1724,7 @@ MCP stores no secrets, but as a general rule keep only non-secret config here.
 
 ## Full Disk Access
 
-Several tools read directly from the Apple Notes SQLite database, which lives in a macOS-protected directory. Those tools require **Full Disk Access** for the process running the MCP server: `get-checklist-state`, `get-note-metadata`, `get-note-blocks`, `get-note-link`, the checklist annotations in `get-note-markdown`, and the database half of `get-sync-status`.
+Several tools read directly from the Apple Notes SQLite database, which lives in a macOS-protected directory. Those tools require **Full Disk Access** for the process running the MCP server: `get-checklist-state`, `get-note-metadata`, `get-note-blocks`, `get-audio-transcripts`, `get-note-link`, the checklist annotations in `get-note-markdown`, and the database half of `get-sync-status`.
 
 > 📘 **For the full why-and-how walkthrough (which app to grant, verifying with `doctor`, graceful degradation), see the [Full Disk Access Setup Guide](https://github.com/sweetrb/apple-notes-mcp/blob/main/docs/FULL-DISK-ACCESS.md).** The summary below is the quick version.
 

package/build/index.js

@@ -24465,14 +24465,14 @@ var require_turndown_cjs = __commonJS({
         } else if (node.nodeType === 1) {
           replacement = replacementForNode.call(self, node);
         }
-        return join15(output, replacement);
+        return join16(output, replacement);
       }, "");
     }
     function postProcess(output) {
       var self = this;
       this.rules.forEach(function(rule) {
         if (typeof rule.append === "function") {
-          output = join15(output, rule.append(self.options));
+          output = join16(output, rule.append(self.options));
         }
       });
       return output.replace(/^[\t\r\n]+/, "").replace(/[\t\r\n\s]+$/, "");
@@ -24484,7 +24484,7 @@ var require_turndown_cjs = __commonJS({
       if (whitespace.leading || whitespace.trailing) content = content.trim();
       return whitespace.leading + rule.replacement(content, node, this.options) + whitespace.trailing;
     }
-    function join15(output, replacement) {
+    function join16(output, replacement) {
       var s1 = trimTrailingNewlines(output);
       var s2 = trimLeadingNewlines(replacement);
       var nls = Math.max(output.length - s1.length, replacement.length - s2.length);
@@ -24777,8 +24777,8 @@ var ZodError = class _ZodError extends Error {
   constructor(issues) {
     super();
     this.issues = [];
-    this.addIssue = (sub3) => {
-      this.issues = [...this.issues, sub3];
+    this.addIssue = (sub4) => {
+      this.issues = [...this.issues, sub4];
     };
     this.addIssues = (subs = []) => {
       this.issues = [...this.issues, ...subs];
@@ -24845,13 +24845,13 @@ var ZodError = class _ZodError extends Error {
   flatten(mapper = (issue2) => issue2.message) {
     const fieldErrors = {};
     const formErrors = [];
-    for (const sub3 of this.issues) {
-      if (sub3.path.length > 0) {
-        const firstEl = sub3.path[0];
+    for (const sub4 of this.issues) {
+      if (sub4.path.length > 0) {
+        const firstEl = sub4.path[0];
         fieldErrors[firstEl] = fieldErrors[firstEl] || [];
-        fieldErrors[firstEl].push(mapper(sub3));
+        fieldErrors[firstEl].push(mapper(sub4));
       } else {
-        formErrors.push(mapper(sub3));
+        formErrors.push(mapper(sub4));
       }
     }
     return { formErrors, fieldErrors };
@@ -29150,12 +29150,12 @@ var $ZodRealError = $constructor("$ZodError", initializer, { Parent: Error });
 function flattenError(error2, mapper = (issue2) => issue2.message) {
   const fieldErrors = {};
   const formErrors = [];
-  for (const sub3 of error2.issues) {
-    if (sub3.path.length > 0) {
-      fieldErrors[sub3.path[0]] = fieldErrors[sub3.path[0]] || [];
-      fieldErrors[sub3.path[0]].push(mapper(sub3));
+  for (const sub4 of error2.issues) {
+    if (sub4.path.length > 0) {
+      fieldErrors[sub4.path[0]] = fieldErrors[sub4.path[0]] || [];
+      fieldErrors[sub4.path[0]].push(mapper(sub4));
     } else {
-      formErrors.push(mapper(sub3));
+      formErrors.push(mapper(sub4));
     }
   }
   return { formErrors, fieldErrors };
@@ -39275,7 +39275,7 @@ function decodeVarint(buf, offset) {
   }
   throw new Error(`Unexpected end of buffer reading varint at offset ${offset}`);
 }
-function decodeMessage(buf) {
+function decodeMessage(buf, options = {}) {
   const fields = [];
   let offset = 0;
   while (offset < buf.length) {
@@ -39296,10 +39296,13 @@ function decodeMessage(buf) {
       const value = buf.slice(offset, offset + length);
       fields.push({ fieldNumber, wireType, value });
       offset += length;
-    } else if (wireType === 5) {
-      offset += 4;
-    } else if (wireType === 1) {
-      offset += 8;
+    } else if (wireType === 5 || wireType === 1) {
+      const width = wireType === 5 ? 4 : 8;
+      if (offset + width > buf.length) break;
+      if (options.keepFixed) {
+        fields.push({ fieldNumber, wireType, value: buf.slice(offset, offset + width) });
+      }
+      offset += width;
     } else {
       break;
     }
@@ -39330,6 +39333,11 @@ function embeddedMessage(field) {
   if (!bytes) return void 0;
   return decodeMessage(bytes);
 }
+function fixed64Double(field) {
+  if (!field || field.wireType !== 1 || !(field.value instanceof Uint8Array)) return void 0;
+  if (field.value.length !== 8) return void 0;
+  return new DataView(field.value.buffer, field.value.byteOffset, 8).getFloat64(0, true);
+}
 var ProtobufDecodeError = class extends Error {
   constructor(message) {
     super(message);
@@ -39901,9 +39909,373 @@ function assertLinkedWrite(rich, content, format, allowLinkChanges = false) {
   }
 }
 
-// src/utils/noteTables.ts
+// src/utils/audioTranscripts.ts
+import { execFileSync as execFileSync4 } from "node:child_process";
+import { homedir as homedir3 } from "node:os";
+import { join as join3 } from "node:path";
 import { gunzipSync as gunzipSync3 } from "node:zlib";
+var NOTES_DB_PATH2 = join3(
+  homedir3(),
+  "Library/Group Containers/group.com.apple.notes/NoteStore.sqlite"
+);
+var DEFAULT_MAX_SEGMENTS = 2e3;
+var MAX_SEGMENTS_LIMIT = 2e4;
+var AudioTranscriptError = class extends Error {
+  constructor(kind, message) {
+    super(message);
+    this.kind = kind;
+    this.name = "AudioTranscriptError";
+  }
+  kind;
+};
+var decode = (bytes) => decodeMessage(bytes, { keepFixed: true });
 var sub = (f, n) => {
+  const bytes = getField(f, n)?.value;
+  return bytes instanceof Uint8Array ? decode(bytes) : void 0;
+};
+var need = (value, what) => {
+  if (value === void 0) throw new Error(`Missing ${what}`);
+  return value;
+};
+var many = (f, n) => getFields(f, n).map((field) => {
+  if (!(field.value instanceof Uint8Array)) throw new Error("Invalid nested entry");
+  return decode(field.value);
+});
+function parseAudioRecording(data) {
+  const root = decode(data);
+  const entries = many(root, 3);
+  if (entries.length === 0) throw new Error("No mergeable objects");
+  if (entries.length > 2e6) throw new Error("Recording too large");
+  const keys = getFields(root, 4).map((f) => stringValue(f) ?? "");
+  const types = getFields(root, 5).map((f) => stringValue(f) ?? "");
+  const uuids = getFields(root, 6).map(
+    (f) => f.value instanceof Uint8Array ? Buffer.from(f.value).toString("hex") : ""
+  );
+  const uuidSlot = /* @__PURE__ */ new Map();
+  uuids.forEach((uuid2, i) => {
+    if (uuid2 && !uuidSlot.has(uuid2)) uuidSlot.set(uuid2, i);
+  });
+  const entry = (index) => {
+    const value = entries[index];
+    if (!value) throw new Error("Invalid object reference");
+    return value;
+  };
+  const customMap = (e) => {
+    const map = sub(e, 13);
+    if (!map) return void 0;
+    const values = /* @__PURE__ */ new Map();
+    for (const item of many(map, 3)) {
+      const key = keys[need(varintValue(getField(item, 1)), "map key")];
+      const value = sub(item, 2);
+      if (key !== void 0 && value) values.set(key, value);
+    }
+    return { type: types[need(varintValue(getField(map, 1)), "map type")] ?? "", values };
+  };
+  const objectIndex = (id2) => id2 ? varintValue(getField(id2, 6)) : void 0;
+  const registerTarget = (id2) => {
+    const index = objectIndex(id2);
+    if (index === void 0) return void 0;
+    const register = sub(entry(index), 1);
+    if (!register) return void 0;
+    const target = objectIndex(sub(register, 2));
+    return target === void 0 ? void 0 : entry(target);
+  };
+  const registerPrimitive = (id2) => {
+    const target = registerTarget(id2);
+    const map = target && customMap(target);
+    if (!map) return void 0;
+    const self = map.values.get("self");
+    if (self) return stringValue(getField(self, 4));
+    const double = map.values.get("doubleValue");
+    if (double) return fixed64Double(getField(double, 3));
+    const integer2 = map.values.get("integerValue");
+    if (integer2) return varintValue(getField(integer2, 2));
+    return void 0;
+  };
+  const registerNoteText = (id2) => {
+    const target = registerTarget(id2);
+    const note = target && sub(target, 10);
+    const text = note && stringValue(getField(note, 2));
+    return text?.replace(/\n+$/u, "") || void 0;
+  };
+  const recordings = entries.map((e) => customMap(e)).filter((m) => m?.type === "com.apple.notes.ICTTAudioRecording");
+  if (recordings.length !== 1) throw new Error("Expected exactly one audio recording object");
+  const recording = recordings[0];
+  const fragments = [];
+  const fragmentList = objectIndex(recording.values.get("fragments"));
+  if (fragmentList !== void 0) {
+    const list = need(sub(entry(fragmentList), 5), "fragment list");
+    for (const item of many(list, 1)) {
+      const fragment = customMap(entry(need(objectIndex(sub(item, 2)), "fragment reference")));
+      if (fragment?.type !== "com.apple.notes.ICTTAudioRecording.Fragment")
+        throw new Error("Unexpected fragment type");
+      const identity = stringValue(getField(fragment.values.get("identity") ?? [], 4));
+      const segments = [];
+      const transcriptRef = objectIndex(fragment.values.get("transcript"));
+      if (transcriptRef !== void 0) {
+        const set = sub(entry(transcriptRef), 15);
+        if (!set) throw new Error("Unsupported transcript container");
+        const bySlot = /* @__PURE__ */ new Map();
+        for (const element of many(sub(set, 2) ?? [], 1)) {
+          const keyMap = customMap(entry(need(objectIndex(sub(element, 1)), "segment key")));
+          const slot = varintValue(getField(keyMap?.values.get("UUIDIndex") ?? [], 2));
+          const value = objectIndex(sub(element, 2));
+          if (slot === void 0 || value === void 0) throw new Error("Invalid segment key");
+          bySlot.set(slot, value);
+        }
+        const ordering = many(need(sub(set, 1), "transcript ordering"), 2).map((pair) => ({
+          index: need(varintValue(getField(pair, 1)), "segment index"),
+          uuid: getField(pair, 2)?.value
+        })).sort((a, b) => a.index - b.index);
+        for (const { uuid: uuid2 } of ordering) {
+          if (!(uuid2 instanceof Uint8Array)) throw new Error("Invalid segment UUID");
+          const slot = uuidSlot.get(Buffer.from(uuid2).toString("hex"));
+          const segmentIndex = slot === void 0 ? void 0 : bySlot.get(slot);
+          if (segmentIndex === void 0) throw new Error("Unresolved transcript segment");
+          const segment = customMap(entry(segmentIndex));
+          if (segment?.type !== "com.apple.notes.ICTTTranscriptSegment")
+            throw new Error("Unexpected segment type");
+          const text = registerPrimitive(segment.values.get("text"));
+          if (typeof text !== "string") throw new Error("Segment without text");
+          const start = registerPrimitive(segment.values.get("timestamp"));
+          const duration3 = registerPrimitive(segment.values.get("duration"));
+          const speaker = registerPrimitive(segment.values.get("speaker"));
+          segments.push({
+            text,
+            ...typeof start === "number" ? { start } : {},
+            ...typeof duration3 === "number" ? { duration: duration3 } : {},
+            ...typeof speaker === "string" && speaker ? { speaker } : {}
+          });
+        }
+      }
+      fragments.push({ ...identity ? { identity } : {}, segments });
+    }
+  }
+  const summary = registerNoteText(recording.values.get("summary"));
+  const topLineSummary = registerNoteText(recording.values.get("topLineSummary"));
+  return {
+    fragments,
+    ...summary ? { summary } : {},
+    ...topLineSummary ? { topLineSummary } : {}
+  };
+}
+function joinSegments(segments) {
+  let out = "";
+  for (const { text } of segments) {
+    if (!text) continue;
+    const glue = !out || /\s$/u.test(out) || /^\s/u.test(text) || /^[.,!?;:%)\]}…'’]/u.test(text) ? "" : " ";
+    out += glue + text;
+  }
+  return out.trim();
+}
+function parseNoteId(noteId3) {
+  const match = /^x-coredata:\/\/([0-9A-Fa-f-]+)\/ICNote\/p(\d+)$/.exec(noteId3);
+  if (!match) {
+    throw new AudioTranscriptError(
+      "invalid_id",
+      `Invalid note ID format: "${noteId3}". Expected format: x-coredata://UUID/ICNote/pNNN`
+    );
+  }
+  return { store: match[1], pk: match[2] };
+}
+var AUDIO_UTI_SQL = "(a.ZTYPEUTI LIKE '%audio%' OR a.ZTYPEUTI IN ('public.mp3'))";
+function buildTranscriptSql(pk, available) {
+  if (!/^\d+$/.test(pk)) throw new Error("Invalid primary key");
+  const optional2 = (column, key, alias = "a") => available.has(column) ? `, '${key}', ${alias}.${column}` : "";
+  const locked = available.has("ZISPASSWORDPROTECTED") ? "COALESCE(n.ZISPASSWORDPROTECTED, 0)" : "0";
+  return [
+    "BEGIN;",
+    // Every statement yields exactly one row, so output lines stay positional.
+    `SELECT json_object('found', (SELECT count(*) FROM ZICCLOUDSYNCINGOBJECT n WHERE n.Z_PK = ${pk}), 'locked', (SELECT ${locked} FROM ZICCLOUDSYNCINGOBJECT n WHERE n.Z_PK = ${pk}));`,
+    `SELECT COALESCE((SELECT hex(ZDATA) FROM ZICNOTEDATA WHERE ZNOTE = ${pk} LIMIT 1), '');`,
+    "SELECT json_group_array(json_object('pk', a.Z_PK, 'identifier', a.ZIDENTIFIER, 'uti', a.ZTYPEUTI, 'data', hex(a.ZMERGEABLEDATA1)" + optional2("ZDURATION", "duration") + optional2("ZNEEDSTRANSCRIPTION", "needsTranscription") + ", 'fragments', json((SELECT json_group_array(json_object('identifier', c.ZIDENTIFIER" + optional2("ZDURATION", "duration", "c") + `)) FROM ZICCLOUDSYNCINGOBJECT c WHERE c.ZPARENTATTACHMENT = a.Z_PK)))) FROM ZICCLOUDSYNCINGOBJECT a WHERE a.ZNOTE = ${pk} AND a.ZPARENTATTACHMENT IS NULL AND ${AUDIO_UTI_SQL};`,
+    "COMMIT;"
+  ].join("\n");
+}
+var REQUIRED_COLUMNS = [
+  "ZMERGEABLEDATA1",
+  "ZPARENTATTACHMENT",
+  "ZTYPEUTI",
+  "ZNOTE",
+  "ZIDENTIFIER"
+];
+function runSqlite(dbPath2, sql) {
+  return execFileSync4("sqlite3", ["-readonly", dbPath2, sql], {
+    encoding: "utf8",
+    timeout: 1e4,
+    maxBuffer: 256 * 1024 * 1024,
+    stdio: ["pipe", "pipe", "pipe"]
+  });
+}
+function bodyAttachmentOrder(gzipped) {
+  const doc = decodeMessage(gunzipSync3(gzipped, { maxOutputLength: 64 * 1024 * 1024 }));
+  const body = embeddedMessage(getField(embeddedMessage(getField(doc, 2)) ?? [], 3));
+  if (!body) throw new Error("Unsupported Notes document structure");
+  const ids = [];
+  for (const run of getFields(body, 5)) {
+    const attachment = embeddedMessage(getField(embeddedMessage(run) ?? [], 12));
+    const id2 = attachment && stringValue(getField(attachment, 1));
+    if (id2 && !ids.includes(id2)) ids.push(id2);
+  }
+  return ids;
+}
+function readAudioTranscripts(noteId3, options = {}) {
+  const { store, pk } = parseNoteId(noteId3);
+  const dbPath2 = options.dbPath ?? NOTES_DB_PATH2;
+  const maxSegments = Math.min(
+    Math.max(1, Math.floor(options.maxSegments ?? DEFAULT_MAX_SEGMENTS)),
+    MAX_SEGMENTS_LIMIT
+  );
+  let lines;
+  try {
+    const available = new Set(
+      runSqlite(dbPath2, "SELECT name FROM pragma_table_info('ZICCLOUDSYNCINGOBJECT');").split("\n").map((line) => line.trim()).filter(Boolean)
+    );
+    const missing = REQUIRED_COLUMNS.filter((c) => !available.has(c));
+    if (missing.length)
+      throw new AudioTranscriptError(
+        "query_error",
+        `This macOS version's Notes database lacks ${missing.join(", ")}; stored transcripts cannot be read.`
+      );
+    lines = runSqlite(dbPath2, buildTranscriptSql(pk, available)).split("\n");
+  } catch (error2) {
+    if (error2 instanceof AudioTranscriptError) throw error2;
+    const message = error2 instanceof Error ? error2.message : String(error2);
+    if (/authorization denied|unable to open database/i.test(message))
+      throw new AudioTranscriptError(
+        "no_fda",
+        `Full Disk Access is required to read stored transcripts. Grant it to the app that launches this server, then fully quit and relaunch it. Setup guide: ${FULL_DISK_ACCESS_GUIDE_URL}`
+      );
+    throw new AudioTranscriptError("query_error", "Failed to read the Notes database.");
+  }
+  const [noteLine = "{}", bodyLine = "", rowsLine = "[]"] = lines;
+  const note = JSON.parse(noteLine || "{}");
+  if (!note.found)
+    throw new AudioTranscriptError(
+      "not_found",
+      `No note found in the database for ID "${noteId3}".`
+    );
+  if (note.locked)
+    throw new AudioTranscriptError(
+      "locked",
+      "This note is password-protected; its transcripts are encrypted and cannot be read."
+    );
+  const rows = JSON.parse(rowsLine || "[]");
+  let order;
+  try {
+    if (/^[0-9A-F]+$/i.test(bodyLine.trim()))
+      order = bodyAttachmentOrder(Buffer.from(bodyLine.trim(), "hex"));
+  } catch {
+    order = void 0;
+  }
+  const ordered = order ? order.flatMap((id2) => rows.filter((row) => row.identifier === id2)) : [...rows].sort((a, b) => a.pk - b.pk);
+  const attachments = ordered.map((row) => describeRow(row, store, options, maxSegments));
+  return { id: noteId3, attachments, bodyOrder: Boolean(order), truncated: false };
+}
+function describeRow(row, store, options, maxSegments) {
+  const childDurations = (row.fragments ?? []).map((f) => f.duration).filter((d) => typeof d === "number" && d > 0);
+  const durationSeconds = typeof row.duration === "number" && row.duration > 0 ? row.duration : childDurations.length ? childDurations.reduce((a, b) => a + b, 0) : void 0;
+  const base = {
+    attachmentId: `x-coredata://${store}/ICAttachment/p${row.pk}`,
+    identifier: row.identifier,
+    typeUti: row.uti,
+    status: "none",
+    ...durationSeconds !== void 0 ? { durationSeconds } : {},
+    ...typeof row.needsTranscription === "number" ? { needsTranscription: row.needsTranscription === 1 } : {}
+  };
+  if (!row.data) return base;
+  let recording;
+  try {
+    recording = parseAudioRecording(Buffer.from(row.data, "hex"));
+  } catch (error2) {
+    return {
+      ...base,
+      status: "undecodable",
+      reason: error2 instanceof Error ? error2.message : String(error2)
+    };
+  }
+  const multi = recording.fragments.length > 1;
+  const all = recording.fragments.flatMap(
+    (fragment, i) => fragment.segments.map((s) => multi ? { ...s, fragment: i } : s)
+  );
+  const text = recording.fragments.map((f) => joinSegments(f.segments)).filter(Boolean).join("\n\n");
+  const speakers = [...new Set(all.flatMap((s) => s.speaker ? [s.speaker] : []))];
+  return {
+    ...base,
+    status: all.length ? "ok" : "none",
+    fragmentCount: recording.fragments.length,
+    wordCount: all.length,
+    ...text ? { text } : {},
+    ...speakers.length ? { speakers } : {},
+    ...recording.summary ? { summary: recording.summary } : {},
+    ...recording.topLineSummary ? { topLineSummary: recording.topLineSummary } : {},
+    ...options.includeSegments && all.length ? {
+      segments: all.slice(0, maxSegments),
+      ...all.length > maxSegments ? { segmentsTruncated: true } : {}
+    } : {}
+  };
+}
+function fitTranscriptsToBudget(result, maxBytes, measure) {
+  if (measure(result) <= maxBytes) return result;
+  let next = {
+    ...result,
+    truncated: true,
+    attachments: result.attachments.map((a) => {
+      if (!a.segments) return a;
+      const rest = { ...a, segmentsTruncated: true };
+      delete rest.segments;
+      return rest;
+    })
+  };
+  for (let share = 0.5; measure(next) > maxBytes && share > 1e-4; share /= 2) {
+    next = {
+      ...next,
+      attachments: next.attachments.map((a) => {
+        const original = result.attachments.find((o) => o.attachmentId === a.attachmentId);
+        if (!original?.text) return a;
+        const keep = Math.floor(original.text.length * share);
+        return { ...a, text: original.text.slice(0, keep), textTruncated: true };
+      })
+    };
+  }
+  return next;
+}
+var clock = (seconds) => {
+  const total = Math.round(seconds);
+  const h = Math.floor(total / 3600);
+  const m = Math.floor(total % 3600 / 60);
+  const s = total % 60;
+  const mm = h ? String(m).padStart(2, "0") : String(m);
+  return `${h ? `${h}:` : ""}${mm}:${String(s).padStart(2, "0")}`;
+};
+function formatTranscriptsText(result) {
+  const count = result.attachments.length;
+  if (count === 0) return `No audio attachments found in note ${result.id}.`;
+  const lines = [`${count} audio attachment${count === 1 ? "" : "s"} in note ${result.id}:`];
+  result.attachments.forEach((a, i) => {
+    const facts = [
+      `status ${a.status}`,
+      ...a.durationSeconds !== void 0 ? [clock(a.durationSeconds)] : [],
+      ...a.wordCount !== void 0 ? [`${a.wordCount} words`] : [],
+      ...a.fragmentCount && a.fragmentCount > 1 ? [`${a.fragmentCount} fragments`] : [],
+      ...a.speakers?.length ? [`${a.speakers.length} speakers`] : [],
+      ...a.reason ? [`reason: ${a.reason}`] : []
+    ];
+    lines.push("", `[${i + 1}] ${a.attachmentId} (${facts.join(", ")})`);
+    if (a.summary) lines.push(`Summary: ${a.summary}`);
+    if (a.text) lines.push(a.textTruncated ? `${a.text} [truncated]` : a.text);
+  });
+  if (result.truncated)
+    lines.push(
+      "",
+      "Some segments or text were left out to stay under the response size limit (APPLE_NOTES_MCP_EXPORT_MAX_BYTES)."
+    );
+  return lines.join("\n");
+}
+
+// src/utils/noteTables.ts
+import { gunzipSync as gunzipSync4 } from "node:zlib";
+var sub2 = (f, n) => {
   const value = embeddedMessage(getField(f, n));
   if (!value) throw new Error(`Missing table field ${n}`);
   return value;
@@ -39913,7 +40285,7 @@ var num = (f, n) => {
   if (v === void 0) throw new Error(`Missing table index ${n}`);
   return v;
 };
-var many = (f, n) => getFields(f, n).map((v) => {
+var many2 = (f, n) => getFields(f, n).map((v) => {
   const m = embeddedMessage(v);
   if (!m) throw new Error("Invalid table entry");
   return m;
@@ -39930,37 +40302,37 @@ function parseNoteTableCells(compressed) {
   return decodeTable(compressed, false);
 }
 function decodeTable(compressed, strict) {
-  const root = decodeMessage(gunzipSync3(compressed, { maxOutputLength: 16 * 1024 * 1024 }));
-  const data = sub(sub(root, 2), 3), entries = many(data, 3);
+  const root = decodeMessage(gunzipSync4(compressed, { maxOutputLength: 16 * 1024 * 1024 }));
+  const data = sub2(sub2(root, 2), 3), entries = many2(data, 3);
   if (entries.length > 1e5) throw new Error("Table too large");
   const keys = getFields(data, 4).map(stringValue), types = getFields(data, 5).map(stringValue), uuids = getFields(data, 6).map(hex);
   const entry = (index) => {
     if (!entries[index]) throw new Error("Invalid table reference");
     return entries[index];
   };
-  const uuidIndex = (index) => num(sub(many(sub(entry(index), 13), 3)[0], 2), 2);
+  const uuidIndex = (index) => num(sub2(many2(sub2(entry(index), 13), 3)[0], 2), 2);
   const roots = entries.filter((e) => {
     const map = embeddedMessage(getField(e, 13));
     return map && types[num(map, 1)] === "com.apple.notes.ICTable";
   });
   if (roots.length !== 1) throw new Error("Ambiguous native table root");
   const refs = new Map(
-    many(sub(roots[0], 13), 3).filter((m) => ["crRows", "crColumns", "cellColumns"].includes(keys[num(m, 1)] || "")).map((m) => [keys[num(m, 1)], num(sub(m, 2), 6)])
+    many2(sub2(roots[0], 13), 3).filter((m) => ["crRows", "crColumns", "cellColumns"].includes(keys[num(m, 1)] || "")).map((m) => [keys[num(m, 1)], num(sub2(m, 2), 6)])
   );
   const ordered = (key) => {
     const ref = refs.get(key);
     if (ref === void 0) throw new Error("Missing table dimension");
-    const ordering = sub(sub(entry(ref), 16), 1), array2 = sub(ordering, 1);
-    const ids = many(array2, 2).map((a) => hex(getField(a, 2)));
+    const ordering = sub2(sub2(entry(ref), 16), 1), array2 = sub2(ordering, 1);
+    const ids = many2(array2, 2).map((a) => hex(getField(a, 2)));
     const map = /* @__PURE__ */ new Map();
     ids.forEach((id2, i) => {
       const index = uuids.indexOf(id2);
       if (index < 0) throw new Error("Missing dimension UUID");
       map.set(index, i);
     });
-    const aliases = many(sub(ordering, 2), 1).map((pair) => [
-      uuidIndex(num(sub(pair, 1), 6)),
-      uuidIndex(num(sub(pair, 2), 6))
+    const aliases = many2(sub2(ordering, 2), 1).map((pair) => [
+      uuidIndex(num(sub2(pair, 1), 6)),
+      uuidIndex(num(sub2(pair, 2), 6))
     ]);
     for (let pass = 0; pass < aliases.length + 1; pass++) {
       let changed = false;
@@ -39980,13 +40352,13 @@ function decodeTable(compressed, strict) {
   const incomplete = [];
   const cellRef = refs.get("cellColumns");
   if (cellRef === void 0) throw new Error("Missing table cells");
-  for (const column of many(sub(entry(cellRef), 6), 1)) {
-    const ci = columns.map.get(uuidIndex(num(sub(column, 1), 6)));
-    const cells = entry(num(sub(column, 2), 6));
-    for (const row of many(sub(cells, 6), 1)) {
-      const ri = rows.map.get(uuidIndex(num(sub(row, 1), 6)));
+  for (const column of many2(sub2(entry(cellRef), 6), 1)) {
+    const ci = columns.map.get(uuidIndex(num(sub2(column, 1), 6)));
+    const cells = entry(num(sub2(column, 2), 6));
+    for (const row of many2(sub2(cells, 6), 1)) {
+      const ri = rows.map.get(uuidIndex(num(sub2(row, 1), 6)));
       if (ri === void 0 || ci === void 0) continue;
-      const note = sub(entry(num(sub(row, 2), 6)), 10);
+      const note = sub2(entry(num(sub2(row, 2), 6)), 10);
       const text = stringValue(getField(note, 2));
       if (text === void 0 || text.includes("\uFFFC")) {
         if (strict) throw new Error("Embedded or unsupported table cell");
@@ -40003,8 +40375,8 @@ function decodeTable(compressed, strict) {
   }
   const rtl = entries.some((e) => {
     const map = embeddedMessage(getField(e, 13));
-    return map && many(map, 3).some(
-      (m) => stringValue(getField(sub(m, 2), 4)) === "CRTableColumnDirectionRightToLeft"
+    return map && many2(map, 3).some(
+      (m) => stringValue(getField(sub2(m, 2), 4)) === "CRTableColumnDirectionRightToLeft"
     );
   });
   const width = columns.ids.length;
@@ -40081,11 +40453,11 @@ function collectNoteTables(rich, noteId3) {
 }
 
 // src/utils/smartFolders.ts
-import { execFileSync as execFileSync4 } from "child_process";
+import { execFileSync as execFileSync5 } from "child_process";
 import * as fs2 from "fs";
 import * as os2 from "os";
 import * as path2 from "path";
-var NOTES_DB_PATH2 = path2.join(
+var NOTES_DB_PATH3 = path2.join(
   os2.homedir(),
   "Library/Group Containers/group.com.apple.notes/NoteStore.sqlite"
 );
@@ -40376,7 +40748,7 @@ WHERE Z_ENT = (SELECT Z_ENT FROM Z_PRIMARYKEY WHERE Z_NAME = 'ICHashtag')
   AND ZSTANDARDIZEDCONTENT IS NOT NULL
   AND COALESCE(ZMARKEDFORDELETION, 0) = 0;
 COMMIT;`;
-var REQUIRED_COLUMNS = [
+var REQUIRED_COLUMNS2 = [
   "ZIDENTIFIER",
   "ZTITLE2",
   "ZFOLDERTYPE",
@@ -40430,21 +40802,21 @@ function buildSmartFolders(output) {
     (a, b) => (a.account ?? "").localeCompare(b.account ?? "") || (a.name ?? "").localeCompare(b.name ?? "") || a.id.localeCompare(b.id)
   );
 }
-function runSqlite(dbPath2, sql) {
-  return execFileSync4("sqlite3", ["-readonly", dbPath2, sql], {
+function runSqlite2(dbPath2, sql) {
+  return execFileSync5("sqlite3", ["-readonly", dbPath2, sql], {
     encoding: "utf8",
     timeout: 5e3,
     maxBuffer: 16 * 1024 * 1024,
     stdio: ["pipe", "pipe", "pipe"]
   });
 }
-function readSmartFolders(dbPath2 = NOTES_DB_PATH2) {
+function readSmartFolders(dbPath2 = NOTES_DB_PATH3) {
   if (!fs2.existsSync(dbPath2)) return { folders: null, error: "no_fda", message: FDA_MESSAGE };
   try {
     const columns = new Set(
-      runSqlite(dbPath2, "SELECT name FROM pragma_table_info('ZICCLOUDSYNCINGOBJECT');").trim().split("\n")
+      runSqlite2(dbPath2, "SELECT name FROM pragma_table_info('ZICCLOUDSYNCINGOBJECT');").trim().split("\n")
     );
-    const missing = REQUIRED_COLUMNS.filter((column) => !columns.has(column));
+    const missing = REQUIRED_COLUMNS2.filter((column) => !columns.has(column));
     if (missing.length) {
       return {
         folders: null,
@@ -40452,7 +40824,7 @@ function readSmartFolders(dbPath2 = NOTES_DB_PATH2) {
         message: `This Notes database does not have the columns smart folders need (${missing.join(", ")}).`
       };
     }
-    return { folders: buildSmartFolders(runSqlite(dbPath2, SMART_FOLDERS_SQL)) };
+    return { folders: buildSmartFolders(runSqlite2(dbPath2, SMART_FOLDERS_SQL)) };
   } catch (error2) {
     const message = error2 instanceof Error ? error2.message : String(error2);
     if (message.includes("authorization denied") || message.includes("unable to open database")) {
@@ -40474,11 +40846,11 @@ import {
   rmSync,
   statSync
 } from "fs";
-import { dirname, isAbsolute, join as join4, relative, resolve, sep } from "path";
-import { homedir as homedir4, tmpdir } from "os";
+import { dirname, isAbsolute, join as join5, relative, resolve, sep } from "path";
+import { homedir as homedir5, tmpdir } from "os";
 function allowedSaveRoots() {
   return [
-    resolve(homedir4()),
+    resolve(homedir5()),
     resolve(tmpdir()),
     "/Volumes",
     "/private/var/folders",
@@ -40552,7 +40924,7 @@ function assertSafeSavePath(p, roots = allowedSaveRoots()) {
   if (suffix.split(sep).includes("..")) {
     throw new Error(`Refusing to write outside allowed locations (home, temp, /Volumes): "${abs}"`);
   }
-  const canonicalDest = suffix ? join4(canonicalAncestor, suffix) : canonicalAncestor;
+  const canonicalDest = suffix ? join5(canonicalAncestor, suffix) : canonicalAncestor;
   const allowed = canonicalRoots(roots);
   if (!isWithinRoots(canonicalAncestor, allowed) || !isWithinRoots(canonicalDest, allowed)) {
     throw new Error(
@@ -40602,8 +40974,8 @@ function cleanupTempDir(dir) {
 // src/services/appleNotesManager.ts
 var import_turndown = __toESM(require_turndown_cjs(), 1);
 import { existsSync as existsSync4 } from "fs";
-import { homedir as homedir5 } from "os";
-import { join as join5 } from "path";
+import { homedir as homedir6 } from "os";
+import { join as join6 } from "path";
 var FIELD_SEP = "";
 var RECORD_SEP = "";
 var AS_FIELD_SEP = "(character id 31)";
@@ -40831,7 +41203,7 @@ function getNoteLinkFromDB(coreDataId2) {
   const match = coreDataId2.match(/\/p(\d+)$/);
   if (!match) return null;
   const pk = parseInt(match[1], 10);
-  const dbPath2 = join5(homedir5(), "Library/Group Containers/group.com.apple.notes/NoteStore.sqlite");
+  const dbPath2 = join6(homedir6(), "Library/Group Containers/group.com.apple.notes/NoteStore.sqlite");
   if (!existsSync4(dbPath2)) return null;
   try {
     const { DatabaseSync } = __require("node:sqlite");
@@ -43140,18 +43512,31 @@ var AppleNotesManager = class {
     }
     return markdown;
   }
+  /**
+   * Reads the transcripts Notes has stored for a note's top-level audio
+   * recordings, one entry per attachment in body order. Read-only: queries the
+   * NoteStore database with `sqlite3 -readonly` and needs Full Disk Access.
+   *
+   * @param id - CoreData URL identifier for the note
+   * @param options - word-level segment inclusion and cap
+   * @throws AudioTranscriptError for an invalid id, a missing or locked note,
+   *   missing Full Disk Access, or a database read failure
+   */
+  getAudioTranscripts(id2, options = {}) {
+    return readAudioTranscripts(id2, options);
+  }
 };
 
 // src/utils/syncDetection.ts
-import { execFileSync as execFileSync5 } from "child_process";
+import { execFileSync as execFileSync6 } from "child_process";
 import * as fs3 from "fs";
 import * as path3 from "path";
 import * as os3 from "os";
-var NOTES_DB_PATH3 = path3.join(
+var NOTES_DB_PATH4 = path3.join(
   os3.homedir(),
   "Library/Group Containers/group.com.apple.notes/NoteStore.sqlite"
 );
-var WAL_PATH = `${NOTES_DB_PATH3}-wal`;
+var WAL_PATH = `${NOTES_DB_PATH4}-wal`;
 var RECENT_ACTIVITY_THRESHOLD_SECONDS = 5;
 var SYNC_STATUS_CACHE_TTL_MS = 2e3;
 var cachedSyncStatus = null;
@@ -43167,7 +43552,7 @@ function getSyncStatus(useCache = true) {
     recentActivity: false
   };
   try {
-    if (!fs3.existsSync(NOTES_DB_PATH3)) {
+    if (!fs3.existsSync(NOTES_DB_PATH4)) {
       status.error = "Notes database not found";
       cachedSyncStatus = status;
       cacheTimestamp = Date.now();
@@ -43188,9 +43573,9 @@ function getSyncStatus(useCache = true) {
         WHERE object.ZCLOUDSTATE = state.Z_PK
       );
     `;
-    const result = execFileSync5(
+    const result = execFileSync6(
       "sqlite3",
-      ["-readonly", NOTES_DB_PATH3, query.replace(/\n/g, " ")],
+      ["-readonly", NOTES_DB_PATH4, query.replace(/\n/g, " ")],
       {
         encoding: "utf8",
         timeout: 5e3,
@@ -43247,11 +43632,11 @@ function withSyncAwarenessSync(operation, fn) {
 }
 
 // src/utils/noteMetadata.ts
-import { execFileSync as execFileSync6 } from "child_process";
+import { execFileSync as execFileSync7 } from "child_process";
 import * as fs4 from "fs";
 import * as path4 from "path";
 import * as os4 from "os";
-var NOTES_DB_PATH4 = path4.join(
+var NOTES_DB_PATH5 = path4.join(
   os4.homedir(),
   "Library/Group Containers/group.com.apple.notes/NoteStore.sqlite"
 );
@@ -43267,15 +43652,15 @@ var COLUMN_MAP = [
   { key: "widgetSnippet", column: "ZWIDGETSNIPPET", type: "text" },
   { key: "smartFolderQuery", column: "ZSMARTFOLDERQUERYJSON", type: "text" }
 ];
-function runSqlite2(query) {
-  return execFileSync6("sqlite3", ["-readonly", NOTES_DB_PATH4, query], {
+function runSqlite3(query) {
+  return execFileSync7("sqlite3", ["-readonly", NOTES_DB_PATH5, query], {
     encoding: "utf8",
     timeout: 5e3,
     stdio: ["pipe", "pipe", "pipe"]
   }).trim();
 }
 function presentColumns() {
-  const out = runSqlite2("PRAGMA table_info(ZICCLOUDSYNCINGOBJECT);");
+  const out = runSqlite3("PRAGMA table_info(ZICCLOUDSYNCINGOBJECT);");
   const cols = /* @__PURE__ */ new Set();
   for (const line of out.split("\n")) {
     const name = line.split("|")[1];
@@ -43293,7 +43678,7 @@ function getNoteMetadata(noteId3) {
     };
   }
   const pk = pkMatch[1];
-  if (!fs4.existsSync(NOTES_DB_PATH4)) {
+  if (!fs4.existsSync(NOTES_DB_PATH5)) {
     return { metadata: null, error: "no_fda", message: FDA_MESSAGE2 };
   }
   try {
@@ -43303,7 +43688,7 @@ function getNoteMetadata(noteId3) {
       return { metadata: {} };
     }
     const pairs = selected.map((c) => `'${c.key}', ${c.column}`).join(", ");
-    const row = runSqlite2(
+    const row = runSqlite3(
       `SELECT json_object(${pairs}) FROM ZICCLOUDSYNCINGOBJECT WHERE Z_PK = ${pk};`
     );
     if (!row) {
@@ -43336,11 +43721,11 @@ function getNoteMetadata(noteId3) {
 }
 
 // src/utils/noteIdentifiers.ts
-import { execFileSync as execFileSync7 } from "child_process";
+import { execFileSync as execFileSync8 } from "child_process";
 import * as fs5 from "fs";
 import * as os5 from "os";
 import * as path5 from "path";
-var NOTES_DB_PATH5 = path5.join(
+var NOTES_DB_PATH6 = path5.join(
   os5.homedir(),
   "Library/Group Containers/group.com.apple.notes/NoteStore.sqlite"
 );
@@ -43418,7 +43803,7 @@ function runJsonQuery(sql, dbPath2) {
   if (!fs5.existsSync(dbPath2)) throw new IdentifierResolutionError("no_fda", NO_FDA_MESSAGE);
   let out;
   try {
-    out = execFileSync7("sqlite3", ["-readonly", dbPath2, sql], {
+    out = execFileSync8("sqlite3", ["-readonly", dbPath2, sql], {
       encoding: "utf8",
       timeout: 5e3,
       stdio: ["pipe", "pipe", "pipe"]
@@ -43438,7 +43823,7 @@ function runJsonQuery(sql, dbPath2) {
 function coreDataId(store, entity2, pk) {
   return `x-coredata://${store}/${entity2}/p${pk}`;
 }
-function resolveIdentifiers(values, entity2, dbPath2 = NOTES_DB_PATH5) {
+function resolveIdentifiers(values, entity2, dbPath2 = NOTES_DB_PATH6) {
   const resolved = /* @__PURE__ */ new Map();
   const keys = [];
   const uuids = [];
@@ -43484,7 +43869,7 @@ function resolveIdentifiers(values, entity2, dbPath2 = NOTES_DB_PATH5) {
   return resolved;
 }
 var COREDATA_PARTS = /^x-coredata:\/\/([0-9A-Fa-f-]+)\/(ICNote|ICFolder|ICAccount)\/p(\d{1,18})$/;
-function lookupStableIdentifiers(ids, entity2, dbPath2 = NOTES_DB_PATH5) {
+function lookupStableIdentifiers(ids, entity2, dbPath2 = NOTES_DB_PATH6) {
   const result = /* @__PURE__ */ new Map();
   const wanted = /* @__PURE__ */ new Map();
   for (const id2 of ids) {
@@ -43520,7 +43905,7 @@ function lookupStableIdentifiers(ids, entity2, dbPath2 = NOTES_DB_PATH5) {
   }
   return result;
 }
-function withStableIdentifiers(items, entity2, dbPath2 = NOTES_DB_PATH5) {
+function withStableIdentifiers(items, entity2, dbPath2 = NOTES_DB_PATH6) {
   const ids = items.map((item) => item.id).filter((id2) => typeof id2 === "string");
   if (ids.length === 0) return items;
   const found = lookupStableIdentifiers(ids, entity2, dbPath2);
@@ -44108,12 +44493,12 @@ function positiveTextTerms(node, negated = false) {
 }
 
 // src/utils/noteQueryStore.ts
-import { execFileSync as execFileSync8 } from "child_process";
+import { execFileSync as execFileSync9 } from "child_process";
 import * as fs6 from "fs";
 import * as os6 from "os";
 import * as path6 from "path";
-import { gunzipSync as gunzipSync4 } from "zlib";
-var NOTES_DB_PATH6 = path6.join(
+import { gunzipSync as gunzipSync5 } from "zlib";
+var NOTES_DB_PATH7 = path6.join(
   os6.homedir(),
   "Library/Group Containers/group.com.apple.notes/NoteStore.sqlite"
 );
@@ -44201,13 +44586,13 @@ function countWords(text) {
   }
   return count;
 }
-var REQUIRED_COLUMNS2 = ["Z_PK", "Z_ENT", "ZTITLE1", "ZFOLDER", "ZMODIFICATIONDATE1"];
+var REQUIRED_COLUMNS3 = ["Z_PK", "Z_ENT", "ZTITLE1", "ZFOLDER", "ZMODIFICATIONDATE1"];
 function col(available, alias, name) {
   return available.has(name) ? `${alias}.${name}` : "NULL";
 }
 var entity = (name) => `(SELECT Z_ENT FROM Z_PRIMARYKEY WHERE Z_NAME='${name}')`;
 function buildScanSql(available, options) {
-  const missing = REQUIRED_COLUMNS2.filter((c) => !available.has(c));
+  const missing = REQUIRED_COLUMNS3.filter((c) => !available.has(c));
   if (missing.length) {
     throw new NoteQueryStoreError(
       `This macOS version's Notes database lacks columns query-notes needs (${missing.join(", ")}).`,
@@ -44248,8 +44633,8 @@ function buildScanSql(available, options) {
     "COMMIT;"
   ].join(" ");
 }
-function runSqlite3(dbPath2, query) {
-  return execFileSync8("sqlite3", ["-readonly", dbPath2, query], {
+function runSqlite4(dbPath2, query) {
+  return execFileSync9("sqlite3", ["-readonly", dbPath2, query], {
     encoding: "utf8",
     timeout: 3e4,
     maxBuffer: 512 * 1024 * 1024,
@@ -44258,7 +44643,7 @@ function runSqlite3(dbPath2, query) {
 }
 function presentColumns2(dbPath2) {
   const cols = /* @__PURE__ */ new Set();
-  for (const line of runSqlite3(dbPath2, "PRAGMA table_info(ZICCLOUDSYNCINGOBJECT);").split("\n")) {
+  for (const line of runSqlite4(dbPath2, "PRAGMA table_info(ZICCLOUDSYNCINGOBJECT);").split("\n")) {
     const name = line.split("|")[1];
     if (name) cols.add(name);
   }
@@ -44313,12 +44698,12 @@ function queryNotes(expression, options = {}) {
   const includeDeleted = options.includeDeleted ?? false;
   const withBodies = needsContent(ast);
   const withTags = needsTags(ast);
-  const dbPath2 = options.dbPath ?? NOTES_DB_PATH6;
+  const dbPath2 = options.dbPath ?? NOTES_DB_PATH7;
   if (!fs6.existsSync(dbPath2)) throw new NoteQueryStoreError(QUERY_FDA_MESSAGE, "no_fda");
   let output;
   try {
     const available = presentColumns2(dbPath2);
-    output = runSqlite3(
+    output = runSqlite4(
       dbPath2,
       buildScanSql(available, { scanLimit, includeDeleted, withBodies, withTags })
     );
@@ -44363,7 +44748,7 @@ function queryNotes(expression, options = {}) {
     const locked = Boolean(row.locked);
     let decoded;
     let content;
-    const decode = () => {
+    const decode2 = () => {
       if (decoded !== void 0) return decoded;
       decoded = null;
       if (locked) return decoded;
@@ -44374,7 +44759,7 @@ function queryNotes(expression, options = {}) {
       try {
         decoded = decodeNoteBody(
           new Uint8Array(
-            gunzipSync4(Buffer.from(row.data, "hex"), { maxOutputLength: 32 * 1024 * 1024 })
+            gunzipSync5(Buffer.from(row.data, "hex"), { maxOutputLength: 32 * 1024 * 1024 })
           )
         );
       } catch {
@@ -44394,7 +44779,7 @@ function queryNotes(expression, options = {}) {
       modified: coreDataMs(row.modified),
       content: () => {
         if (content !== void 0) return content;
-        const body2 = decode();
+        const body2 = decode2();
         if (!body2) return content = null;
         const text = body2.text;
         const firstBreak = text.indexOf("\n");
@@ -44419,7 +44804,7 @@ function queryNotes(expression, options = {}) {
     if (!evaluateNoteQuery(ast, note)) continue;
     matched++;
     if (hits.length >= limit) continue;
-    const body = locked ? null : decode();
+    const body = locked ? null : decode2();
     hits.push({
       id: `x-coredata://${uuid2}/ICNote/p${row.pk}`,
       title: row.title ?? "",
@@ -44449,10 +44834,10 @@ function queryNotes(expression, options = {}) {
 import { spawnSync } from "child_process";
 
 // src/services/nativeTags.ts
-import { execFileSync as execFileSync9 } from "node:child_process";
+import { execFileSync as execFileSync10 } from "node:child_process";
 import { mkdtempSync as mkdtempSync2, writeFileSync, rmSync as rmSync2 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 
 // src/services/shortcutConsent.ts
 function shortcutConsentHint(shortcut) {
@@ -44528,7 +44913,7 @@ function addNativeTags(request, deps) {
   };
 }
 function listInstalledShortcuts() {
-  return execFileSync9("/usr/bin/shortcuts", ["list", "--show-identifiers"], {
+  return execFileSync10("/usr/bin/shortcuts", ["list", "--show-identifiers"], {
     encoding: "utf8",
     timeout: 15e3,
     maxBuffer: 1024 * 1024,
@@ -44554,11 +44939,11 @@ function runNativeTagsShortcut(input) {
   const status = nativeTagsStatus();
   if (!status.installed)
     throw new Error(`Import the supplied ${status.shortcut}.shortcut in Shortcuts first`);
-  const directory = mkdtempSync2(join10(tmpdir2(), "apple-notes-native-tags-"));
+  const directory = mkdtempSync2(join11(tmpdir2(), "apple-notes-native-tags-"));
   try {
-    const path7 = join10(directory, "request.json");
+    const path7 = join11(directory, "request.json");
     writeFileSync(path7, JSON.stringify(input), { mode: 384 });
-    execFileSync9("/usr/bin/shortcuts", ["run", status.identifier, "--input-path", path7], {
+    execFileSync10("/usr/bin/shortcuts", ["run", status.identifier, "--input-path", path7], {
       encoding: "utf8",
       timeout: 6e4,
       maxBuffer: 1024 * 1024,
@@ -44577,10 +44962,10 @@ function runNativeTagsShortcut(input) {
 }
 
 // src/services/backgroundNotes.ts
-import { execFileSync as execFileSync10 } from "node:child_process";
+import { execFileSync as execFileSync11 } from "node:child_process";
 import { mkdtempSync as mkdtempSync3, writeFileSync as writeFileSync2, rmSync as rmSync3 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 
 // src/utils/appendMarkdown.ts
 var escape2 = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
@@ -44769,9 +45154,9 @@ function runBackgroundShortcut(input, status = backgroundStatus()) {
     throw new Error(
       `Install the supplied "${status.shortcut}" Shortcut once; Shortcuts must list it exactly once`
     );
-  const directory = mkdtempSync3(join11(tmpdir3(), "apple-notes-background-"));
+  const directory = mkdtempSync3(join12(tmpdir3(), "apple-notes-background-"));
   try {
-    const file = join11(directory, "request.json");
+    const file = join12(directory, "request.json");
     writeFileSync2(
       file,
       JSON.stringify({
@@ -44791,7 +45176,7 @@ function runBackgroundShortcut(input, status = backgroundStatus()) {
       { mode: 384 }
     );
     try {
-      execFileSync10("/usr/bin/shortcuts", ["run", status.identifier, "--input-path", file], {
+      execFileSync11("/usr/bin/shortcuts", ["run", status.identifier, "--input-path", file], {
         encoding: "utf8",
         timeout: 6e4,
         maxBuffer: 1024 * 1024,
@@ -45083,7 +45468,7 @@ ${request.content}`
 }
 
 // src/services/capabilityMatrix.ts
-import { execFileSync as execFileSync11 } from "node:child_process";
+import { execFileSync as execFileSync12 } from "node:child_process";
 import { release } from "node:os";
 var MACOS_SHORTCUTS_CLI = "12.0";
 var MACOS_MARKDOWN_IMPORT = "26.0";
@@ -45290,7 +45675,7 @@ function evaluateFeatures(env, features = FEATURES) {
 function readMacOSVersion() {
   if (process.platform !== "darwin") return null;
   try {
-    const out = execFileSync11("/usr/bin/sw_vers", ["-productVersion"], {
+    const out = execFileSync12("/usr/bin/sw_vers", ["-productVersion"], {
       encoding: "utf8",
       timeout: 3e3,
       stdio: ["ignore", "pipe", "ignore"]
@@ -45444,12 +45829,12 @@ function formatDoctorReport(r) {
 
 // src/services/fileConfig.ts
 import { existsSync as existsSync9, readFileSync as readFileSync2 } from "fs";
-import { join as join12 } from "path";
-import { homedir as homedir10 } from "os";
+import { join as join13 } from "path";
+import { homedir as homedir11 } from "os";
 function fileConfigPath(env = process.env) {
   const override = env.APPLE_NOTES_MCP_CONFIG_FILE;
   if (override && override.trim()) return override.trim();
-  return join12(homedir10(), "Library", "Application Support", "apple-notes-mcp", "config.json");
+  return join13(homedir11(), "Library", "Application Support", "apple-notes-mcp", "config.json");
 }
 function loadFileConfig(env = process.env, path7 = fileConfigPath(env)) {
   const applied = [];
@@ -45752,11 +46137,11 @@ function createShutdown(stream, exit, timeoutMs = SHUTDOWN_DRAIN_TIMEOUT_MS) {
 }
 
 // src/utils/noteBlocks.ts
-import { execFileSync as execFileSync12 } from "node:child_process";
+import { execFileSync as execFileSync13 } from "node:child_process";
 import { existsSync as existsSync10 } from "node:fs";
-import { homedir as homedir11 } from "node:os";
-import { join as join13 } from "node:path";
-import { gunzipSync as gunzipSync5 } from "node:zlib";
+import { homedir as homedir12 } from "node:os";
+import { join as join14 } from "node:path";
+import { gunzipSync as gunzipSync6 } from "node:zlib";
 var NoteBlocksError = class extends Error {
   code;
   constructor(code, message) {
@@ -45805,7 +46190,7 @@ var stringOf = (fields, n) => {
   const b = bytesOf(fields, n);
   return b ? utf8.decode(b) : void 0;
 };
-var sub2 = (fields, n) => {
+var sub3 = (fields, n) => {
   const b = bytesOf(fields, n);
   return b ? decodeWireFields(b) : void 0;
 };
@@ -45838,7 +46223,7 @@ function decodeParagraph(fields, tally) {
     blockQuote: (varintOf(fields, 8) ?? 0) !== 0
   };
   if (attrs.styleType === -1) attrs.styleType = null;
-  const checklist = sub2(fields, 5);
+  const checklist = sub3(fields, 5);
   const checklistId = checklist && bytesOf(checklist, 1);
   if (attrs.styleType === 103 && checklistId)
     attrs.checklist = { id: hex2(checklistId), done: varintOf(checklist, 2) === 1 };
@@ -45848,7 +46233,7 @@ function decodeParagraph(fields, tally) {
 }
 function decodeInline(fields) {
   const inline = {};
-  const font = sub2(fields, 3);
+  const font = sub3(fields, 3);
   const hints = font ? varintOf(font, 3) ?? 0 : 0;
   const weight = varintOf(fields, 5) ?? 0;
   if (weight === 1 || weight === 3 || hints & 1) inline.bold = true;
@@ -45858,7 +46243,7 @@ function decodeInline(fields) {
   const baseline = varintOf(fields, 8) ?? 0;
   if (baseline > 0) inline.superscript = true;
   if (baseline < 0) inline.subscript = true;
-  const color = sub2(fields, 10);
+  const color = sub3(fields, 10);
   const colorValue = color && colorOf(color);
   if (colorValue) inline.color = colorValue;
   const emphasis = varintOf(fields, 14);
@@ -45880,7 +46265,7 @@ function decodeInline(fields) {
         ...size !== void 0 && Number.isFinite(size) ? { size } : {}
       };
   }
-  const attachment = sub2(fields, 12);
+  const attachment = sub3(fields, 12);
   const attachmentId = attachment && stringOf(attachment, 1);
   if (attachmentId)
     inline.attachment = { id: attachmentId, uti: stringOf(attachment, 2) || "unknown" };
@@ -45895,8 +46280,8 @@ function wrap(error2) {
 function decodeNoteBlocks(data) {
   let note;
   try {
-    const document = sub2(decodeWireFields(data), 2);
-    note = document && sub2(document, 3);
+    const document = sub3(decodeWireFields(data), 2);
+    note = document && sub3(document, 3);
   } catch (error2) {
     wrap(error2);
   }
@@ -45921,7 +46306,7 @@ function decodeNoteBlocks(data) {
       runs.push({
         start: position,
         length,
-        paragraph: decodeParagraph(sub2(fields, 2), paragraphTally),
+        paragraph: decodeParagraph(sub3(fields, 2), paragraphTally),
         inline: decodeInline(fields)
       });
       position += length;
@@ -46044,7 +46429,7 @@ function summarize(blocks, attachments) {
 function decodeCompressedNoteBlocks(compressed) {
   let data;
   try {
-    data = gunzipSync5(compressed, { maxOutputLength: 32 * 1024 * 1024 });
+    data = gunzipSync6(compressed, { maxOutputLength: 32 * 1024 * 1024 });
   } catch (error2) {
     throw new NoteBlocksError(
       "decompress-failed",
@@ -46098,11 +46483,11 @@ function pageNoteBlocks(doc, { offset = 0, limit = 500, maxBytes = blocksMaxResp
     undecodedFields: doc.undecodedFields
   };
 }
-var NOTES_DB_PATH7 = join13(
-  homedir11(),
+var NOTES_DB_PATH8 = join14(
+  homedir12(),
   "Library/Group Containers/group.com.apple.notes/NoteStore.sqlite"
 );
-function readNoteBlocks(id2, { dbPath: dbPath2 = NOTES_DB_PATH7 } = {}) {
+function readNoteBlocks(id2, { dbPath: dbPath2 = NOTES_DB_PATH8 } = {}) {
   const pk = /^x-coredata:\/\/[0-9a-f-]+\/ICNote\/p([0-9]{1,18})$/i.exec(id2)?.[1];
   if (!pk)
     throw new NoteBlocksError(
@@ -46114,7 +46499,7 @@ function readNoteBlocks(id2, { dbPath: dbPath2 = NOTES_DB_PATH7 } = {}) {
   const sql = "SELECT json_object('exists', (SELECT count(*) FROM ZICCLOUDSYNCINGOBJECT WHERE Z_PK = @pk AND Z_ENT = (SELECT Z_ENT FROM Z_PRIMARYKEY WHERE Z_NAME = 'ICNote')), 'data', (SELECT hex(ZDATA) FROM ZICNOTEDATA WHERE ZNOTE = @pk), 'encrypted', (SELECT ZCRYPTOINITIALIZATIONVECTOR IS NOT NULL FROM ZICNOTEDATA WHERE ZNOTE = @pk));";
   let output;
   try {
-    output = execFileSync12(
+    output = execFileSync13(
       "/usr/bin/sqlite3",
       ["-readonly", "-cmd", ".parameter init", "-cmd", `.parameter set @pk ${pk}`, dbPath2, sql],
       {
@@ -46275,7 +46660,7 @@ import {
   writeFileSync as writeFileSync3
 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
-import { basename, isAbsolute as isAbsolute2, join as join14 } from "node:path";
+import { basename, isAbsolute as isAbsolute2, join as join15 } from "node:path";
 var noteId = exactIdInput(
   "ICNote",
   /^x-coredata:\/\/[0-9a-f-]+\/ICNote\/p\d+$/i,
@@ -46389,8 +46774,8 @@ function registerDirectOperations(server2, manager) {
       if (before.hash !== expectedContentHash) throw new Error("Note revision changed");
       const bytes = localAttachment(path7);
       const beforeAttachments = manager.listAttachmentsById(id2);
-      const directory = mkdtempSync4(join14(tmpdir4(), "notes-attachment-add-"));
-      const temporaryFile = join14(directory, basename(path7));
+      const directory = mkdtempSync4(join15(tmpdir4(), "notes-attachment-add-"));
+      const temporaryFile = join15(directory, basename(path7));
       try {
         writeFileSync3(temporaryFile, bytes, { mode: 384 });
         if (readSnapshot(manager, id2).hash !== before.hash)
@@ -49098,6 +49483,44 @@ ${summary}`,
     );
   }, "Error reading checklist state")
 );
+registerTool(
+  "get-audio-transcripts",
+  {
+    description: "Use when: reading the transcript (and summary, if any) that Notes already computed for the audio recordings in one note, by id.\nReturns: one entry per top-level audio attachment in body order, with attachmentId, durationSeconds, status (ok, none when no transcript is stored, or undecodable with a reason), joined transcript text, wordCount, speakers and summary when stored, and optional word-level segments.\nDo not use when: you need the audio file itself (save-attachment) or the note body (get-note-content). This tool does not transcribe; it only reads what Notes stored.\nSafety: read-only; requires Full Disk Access and reads the NoteStore database. Password-protected notes are refused. Large responses drop segments first, then shorten text, to stay under APPLE_NOTES_MCP_EXPORT_MAX_BYTES.",
+    inputSchema: {
+      id: noteIdInput,
+      includeSegments: external_exports.boolean().optional().describe(
+        "Also return word-level segments (text, start and duration in seconds, speaker). Default false."
+      ),
+      maxSegments: external_exports.number().int().min(1).max(MAX_SEGMENTS_LIMIT).optional().describe(
+        `Cap on segments returned per attachment when includeSegments is true (default ${DEFAULT_MAX_SEGMENTS}).`
+      )
+    },
+    outputSchema: {
+      id: external_exports.string().optional(),
+      attachments: external_exports.array(external_exports.object({}).passthrough()).optional(),
+      bodyOrder: external_exports.boolean().optional(),
+      truncated: external_exports.boolean().optional()
+    },
+    annotations: { readOnlyHint: true }
+  },
+  withErrorHandling(({ id: id2, includeSegments, maxSegments }) => {
+    let result;
+    try {
+      result = notesManager.getAudioTranscripts(id2, { includeSegments, maxSegments });
+    } catch (error2) {
+      if (error2 instanceof AudioTranscriptError) return errorResponse(error2.message);
+      throw error2;
+    }
+    const toResponse = (r) => successResponse(formatTranscriptsText(r), { ...r });
+    const fitted = fitTranscriptsToBudget(
+      result,
+      exportMaxResponseBytes(),
+      (r) => Buffer.byteLength(JSON.stringify(toResponse(r)))
+    );
+    return toResponse(fitted);
+  }, "Error reading audio transcripts")
+);
 registerTool(
   "get-note-metadata",
   {

package/package.json

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