apple-voice-memos-mcp 1.0.0

package/README.md

@@ -0,0 +1,63 @@
+# apple-voice-memos-mcp
+
+MCP server for **Apple Voice Memos** (Memo Vocali) on macOS — with **auto-setup**.
+
+## Quick start (one command)
+
+```bash
+npx apple-voice-memos-mcp --setup
+```
+
+Then add to your MCP config (Claude Desktop, pi, Cursor, etc.):
+
+```json
+{
+  "mcpServers": {
+    "apple-voice-memos": {
+      "command": "npx",
+      "args": ["apple-voice-memos-mcp"]
+    }
+  }
+}
+```
+
+## Why the setup?
+
+macOS protects Voice Memos data (database + audio) with **Full Disk Access** — a privacy
+permission that, unlike AppleScript automation, **cannot be granted programmatically or
+via automatic prompt**. This package minimizes the manual work to:
+
+1. `npx apple-voice-memos-mcp --setup` — builds a signed helper app
+   (`VoiceMemosMCP.app`), registers a LaunchAgent daemon, and opens the Full Disk Access
+   panel for you
+2. Drag **VoiceMemosMCP.app** into the Full Disk Access list (once, ~10 seconds)
+3. Restart your MCP client (or `/reload`)
+
+The architecture (MCP client → stdio → local TCP daemon launched via launchd → signed app)
+is what makes the permission stick reliably — plain `node` processes inherit the
+permissions of their parent, which is why direct setups silently fail.
+
+## MCP Tools
+
+- `list_voice_memos` — list memos with metadata (limit/offset/search)
+- `get_voice_memo` — full metadata for one memo
+- `get_audio` — the audio file (path or base64)
+- `get_transcript` — Apple's embedded transcript, if present
+- `transcribe_memo` — on-demand transcription via Apple Speech Recognition
+
+## Status
+
+```bash
+npx apple-voice-memos-mcp --status
+```
+
+## Requirements
+
+- macOS 14+ (Voice Memos app opened at least once)
+- Node.js 18+ (26.x tested — uses better-sqlite3 prebuilds, no compilation)
+- Xcode Command Line Tools (for the 1-second launcher compile during setup)
+
+## Credits
+
+Server implementation forked from [jwulff/apple-voice-memo-mcp](https://github.com/jwulff/apple-voice-memo-mcp),
+with a Node 26 compatibility fix (better-sqlite3 13) and the TCC/LaunchAgent architecture.

package/bin/cli.js

@@ -0,0 +1,352 @@
+#!/usr/bin/env node
+/**
+ * apple-voice-memos-mcp — CLI entry point
+ *
+ * Uso:
+ *   apple-voice-memos-mcp            → avvia il server MCP in stdio (config npx standard)
+ *   apple-voice-memos-mcp --setup    → setup guidato (app firmata + LaunchAgent + pannello FDA)
+ *   apple-voice-memos-mcp --status   → stato del demone e dei permessi
+ *
+ * Architettura (risolve TCC/Full Disk Access su macOS):
+ *   gateway MCP → [stdio] → cli.js (questo file) → [TCP 127.0.0.1] → demone (launchd)
+ *   Il demone è lanciato da launchd come VoiceMemosMCP.app (firmata) → eredita
+ *   il Full Disk Access e genera un'istanza del server MCP per connessione.
+ */
+import { spawn, execSync } from "child_process";
+import { existsSync, mkdirSync, writeFileSync, copyFileSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import net from "net";
+import os from "os";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const HOME = os.homedir();
+
+const APP_DIR = join(HOME, "Library", "apple-voice-memos-mcp");
+const APP_PATH = join(APP_DIR, "VoiceMemosMCP.app");
+const APP_EXEC = join(APP_PATH, "Contents", "MacOS", "VoiceMemosMCP");
+const APP_NODE = join(APP_PATH, "Contents", "MacOS", "noded");
+const APP_LIB_DIR = join(APP_PATH, "Contents", "lib");
+const PLIST_PATH = join(HOME, "Library", "LaunchAgents", "it.otomatik.voicememosmcp.plist");
+const TCP_PORT = 8917;
+const TCP_HOST = "127.0.0.1";
+const SERVER_JS = join(__dirname, "..", "src", "dist", "index.js");
+
+const PLIST = (nodePath, daemonJs) => `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>Label</key>
+	<string>it.otomatik.voicememosmcp</string>
+	<key>ProgramArguments</key>
+	<array>
+		<string>${nodePath}</string>
+		<string>${daemonJs}</string>
+	</array>
+	<key>RunAtLoad</key>
+	<true/>
+	<key>KeepAlive</key>
+	<true/>
+	<key>StandardErrorPath</key>
+	<string>/tmp/apple-voice-memos-mcp-daemon.err</string>
+</dict>
+</plist>
+`;
+
+const DAEMON_JS = `#!/usr/bin/env node
+// Demone TCP generato da apple-voice-memos-mcp: per ogni connessione
+// lancia un'istanza stdio del server MCP. Lanciato da launchd → eredita FDA.
+const net = require('net');
+const { spawn } = require('child_process');
+const SERVER_JS = ${JSON.stringify(SERVER_JS)};
+const NODE = ${JSON.stringify(process.execPath)};
+const PORT = ${TCP_PORT};
+
+const server = net.createServer((socket) => {
+  const child = spawn(NODE, [SERVER_JS], { stdio: ['pipe', 'pipe', 'pipe'] });
+  socket.pipe(child.stdin);
+  child.stdout.pipe(socket);
+  child.stderr.on('data', () => {});
+  child.on('exit', () => socket.end());
+  socket.on('close', () => { try { child.kill(); } catch (e) {} });
+  socket.on('error', () => {});
+});
+server.listen(PORT, '127.0.0.1', () => console.error('apple-voice-memos-mcp daemon on :' + PORT));
+`;
+
+function log(msg) {
+  process.stderr.write(`[apple-voice-memos-mcp] ${msg}\n`);
+}
+
+function portOpen(port) {
+  return new Promise((resolve) => {
+    const sock = net.connect(port, TCP_HOST);
+    sock.setTimeout(1500);
+    sock.on("connect", () => { sock.destroy(); resolve(true); });
+    sock.on("error", () => resolve(false));
+    sock.on("timeout", () => { sock.destroy(); resolve(false); });
+  });
+}
+
+/** Crea (o aggiorna) l'app VoiceMemosMCP.app firmata che avvia il demone */
+function buildApp() {
+  // 1. launcher C che esegue node con il demone — compila con cc (presente con Xcode CLT)
+  const launcherC = `/tmp/avmm-launcher.c`;
+  const launcherBin = `/tmp/avmm-launcher`;
+  writeFileSync(
+    launcherC,
+    `#include <unistd.h>
+#include <stdlib.h>
+#include <libgen.h>
+#include <stdio.h>
+#include <string.h>
+#include <mach-o/dyld.h>
+
+int main(int argc, char **argv) {
+    char exe_path[4096];
+    uint32_t size = sizeof(exe_path);
+    if (_NSGetExecutablePath(exe_path, &size) != 0) return 1;
+    char *dir = dirname(exe_path);   // Contents/MacOS
+
+    char node_path[4096];
+    snprintf(node_path, sizeof(node_path), "%s/noded", dir);
+
+    char server_path[4096];
+    snprintf(server_path, sizeof(server_path), "%s/dist/index.js", dir);
+
+    char libdir[4096];
+    snprintf(libdir, sizeof(libdir), "%s/../lib", dir);
+    setenv("DYLD_LIBRARY_PATH", libdir, 1);
+
+    execl(node_path, "noded", server_path, (char *)NULL);
+    perror("execl failed");
+    return 1;
+}
+`
+  );
+  execSync(`cc -o ${launcherBin} ${launcherC}`);
+
+  // 2. struttura bundle
+  mkdirSync(join(APP_PATH, "Contents", "MacOS"), { recursive: true });
+  mkdirSync(join(APP_PATH, "Contents", "lib"), { recursive: true });
+
+  writeFileSync(
+    join(APP_PATH, "Contents", "Info.plist"),
+    `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleIdentifier</key>
+	<string>it.otomatik.voicememosmcp</string>
+	<key>CFBundleName</key>
+	<string>VoiceMemosMCP</string>
+	<key>CFBundleExecutable</key>
+	<string>VoiceMemosMCP</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleVersion</key>
+	<string>1.0.0</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0.0</string>
+	<key>LSUIElement</key>
+	<true/>
+</dict>
+</plist>
+`
+  );
+
+  copyFileSync(launcherBin, APP_EXEC);
+  chmod(APP_EXEC, 0o755);
+
+  // 3. copia node + libnode DENTRO l'app (binario dedicato per TCC)
+  const nodeBin = process.execPath;
+  copyFileSync(nodeBin, APP_NODE);
+  chmod(APP_NODE, 0o755);
+
+  // libnode: cerca TUTTE le libnode*.dylib e le copia con il nome originale
+  try {
+    const realNode = execSync(`readlink -f ${nodeBin}`).toString().trim();
+    const nodeDir = dirname(realNode); // .../bin
+    mkdirSync(APP_LIB_DIR, { recursive: true });
+    try {
+      const libDir = join(nodeDir, "..", "lib");
+      const libs = execSync(`ls ${libDir}/libnode*.dylib 2>/dev/null`).toString().trim().split("\n").filter(Boolean);
+      for (const lib of libs) {
+        const dest = join(APP_LIB_DIR, lib.split("/").pop());
+        copyFileSync(lib, dest);
+        chmod(dest, 0o755);
+      }
+    } catch (e) { /* node statico o bundled: continua */ }
+
+    // rpath del nodo copiato → punta a ../lib dentro il bundle
+    try {
+      execSync(`install_name_tool -add_rpath "@executable_path/../lib" ${APP_NODE} 2>/dev/null || true`);
+    } catch (e) { /* rpath già presente */ }
+  } catch (e) { /* readlink fallito: node forse statico */ }
+
+  // 4. copia l'INTERA dist del server dentro Contents/MacOS/dist (entry index.js)
+  //    I moduli (better-sqlite3, sdk, zod) si risolvono via NODE_PATH verso i node_modules del pacchetto
+  const pkgRoot = join(__dirname, "..");
+  const distSrc = join(pkgRoot, "src", "dist");
+  const distDst = join(APP_PATH, "Contents", "MacOS", "dist");
+  mkdirSync(distDst, { recursive: true });
+  execSync(`cp -R "${distSrc}/." "${distDst}/"`);
+  // ESM risolve i bare imports SOLO dal node_modules relativo: creo un symlink
+  // Contents/MacOS/dist/node_modules → node_modules del pacchetto installato
+  try { execSync(`rm -f "${join(distDst, 'node_modules')}"`); } catch (e) {}
+  execSync(`ln -s "${join(pkgRoot, 'node_modules')}" "${join(distDst, 'node_modules')}"`);
+
+  // 5. firma
+  execSync(`codesign --force --deep --sign - "${APP_PATH}" 2>/dev/null`);
+}
+
+function chmod(p, mode) {
+  try { execSync(`chmod ${mode.toString(8)} "${p}"`); } catch (e) {}
+}
+
+/** Registra il LaunchAgent e avvia il demone */
+function installDaemon() {
+  writeFileSync(join(APP_DIR, "daemon.js"), DAEMON_JS);
+  writeFileSync(PLIST_PATH, PLIST(APP_NODE, join(APP_DIR, "daemon.js")));
+  try { execSync(`launchctl unload "${PLIST_PATH}" 2>/dev/null`); } catch (e) {}
+  execSync(`launchctl load "${PLIST_PATH}"`);
+}
+
+/** Setup guidato */
+async function setup() {
+  log("Setup apple-voice-memos-mcp…");
+  log("1/4 · Compilo il launcher e creo l'app VoiceMemosMCP.app…");
+  buildApp();
+  log("   ✓ " + APP_PATH);
+
+  log("2/4 · Registro il LaunchAgent…");
+  installDaemon();
+  log("   ✓ demone TCP su " + TCP_HOST + ":" + TCP_PORT);
+
+  // attesa che il demone risponda
+  const up = await portOpen(TCP_PORT);
+  log(up ? "   ✓ demone attivo" : "   ⚠ demone non risponde (riproverà il gateway)");
+
+  log("3/4 · Permessi macOS (Full Disk Access)…");
+  log("");
+  log("   ╔══════════════════════════════════════════════════════════╗");
+  log("   ║  AZIONE MANUALE RICHIESTA (una volta sola, 10 secondi)   ║");
+  log("   ║                                                          ║");
+  log("   ║  Nel pannello che sto per aprire:                        ║");
+  log("   ║    1. clicca \"+\"                                         ║");
+  log("   ║    2. premi Cmd+Shift+G e incolla:                       ║");
+  log(`   ║       ${APP_PATH.slice(0, 42)}   ║`);
+  log(`   ║       ${APP_PATH.slice(42)}                             ║`);
+  log("   ║    3. seleziona VoiceMemosMCP.app e attivala             ║");
+  log("   ╚══════════════════════════════════════════════════════════╝");
+  log("");
+  try { execSync(`open "x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles"`); } catch (e) {}
+  log("4/4 · Al termine riavvia il client MCP (o esegui /reload). Fatto! ✅");
+}
+
+/** Status */
+async function status() {
+  const up = await portOpen(TCP_PORT);
+  console.log("Demone TCP (" + TCP_HOST + ":" + TCP_PORT + "): " + (up ? "ATTIVO ✅" : "NON ATTIVO ❌"));
+  console.log("App: " + (existsSync(APP_PATH) ? "presente ✅" : "assente ❌") + "  → " + APP_PATH);
+  console.log("LaunchAgent: " + (existsSync(PLIST_PATH) ? "registrato ✅" : "assente ❌"));
+  // test lettura DB (se il demone è attivo, chiede la lista)
+  if (up) {
+    try {
+      const res = await callMcp("list_voice_memos", { limit: 1 });
+      console.log("Accesso al DB Memo Vocali: OK ✅  (" + res.total + " memo)");
+    } catch (e) {
+      console.log("Accesso al DB Memo Vocali: NEGATO ❌ → manca Full Disk Access su VoiceMemosMCP.app");
+      console.log("  Esegui: apple-voice-memos-mcp --setup");
+    }
+  }
+}
+
+function callMcp(tool, args) {
+  return new Promise((resolve, reject) => {
+    const sock = net.connect(TCP_PORT, TCP_HOST);
+    let buf = "";
+    sock.on("connect", () => {
+      sock.write(JSON.stringify({ jsonrpc: "2.0", id: 1, method: "initialize", params: { protocolVersion: "2024-11-05", capabilities: {}, clientInfo: { name: "status", version: "1" } } }) + "\n");
+      setTimeout(() => {
+        sock.write(JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" }) + "\n");
+        sock.write(JSON.stringify({ jsonrpc: "2.0", id: 2, method: "tools/call", params: { name: tool, arguments: args } }) + "\n");
+      }, 300);
+    });
+    sock.on("data", (d) => {
+      buf += d.toString();
+      const lines = buf.split("\n");
+      buf = lines.pop();
+      for (const line of lines) {
+        try {
+          const msg = JSON.parse(line);
+          if (msg.id === 2) {
+            sock.destroy();
+            if (msg.result?.isError) return reject(new Error(msg.result.content?.[0]?.text));
+            return resolve(JSON.parse(msg.result.content[0].text));
+          }
+        } catch (e) {}
+      }
+    });
+    sock.on("error", reject);
+    setTimeout(() => { sock.destroy(); reject(new Error("timeout")); }, 8000);
+  });
+}
+
+/** Modalità server stdio per il gateway MCP: bridge verso il demone TCP con auto-bootstrap */
+async function serveStdio() {
+  // se il demone non risponde, prova a installarlo/riavviarlo al volo
+  let up = await portOpen(TCP_PORT);
+  if (!up && existsSync(APP_PATH) && existsSync(PLIST_PATH)) {
+    try {
+      execSync(`launchctl unload "${PLIST_PATH}" 2>/dev/null; launchctl load "${PLIST_PATH}"`);
+      await new Promise((r) => setTimeout(r, 2000));
+      up = await portOpen(TCP_PORT);
+    } catch (e) {}
+  }
+  if (!up) {
+    process.stderr.write(
+      "\n[apple-voice-memos-mcp] Demone non attivo. Esegui il setup una volta sola:\n" +
+      "  npx apple-voice-memos-mcp --setup\n\n"
+    );
+    // resta comunque in stdio e prova a servire localmente senza demone (fallirà sui dati ma il client MCP non crasha)
+  }
+
+  if (up) {
+    // bridge stdio <-> TCP
+    const sock = net.connect(TCP_PORT, TCP_HOST);
+    sock.on("error", () => process.exit(1));
+    process.stdin.pipe(sock);
+    sock.pipe(process.stdout);
+    process.stdin.on("end", () => sock.end());
+    sock.on("close", () => process.exit(0));
+  } else {
+    // echo server minimo per non far crashare il gateway
+    let b = "";
+    process.stdin.on("data", (d) => {
+      b += d.toString();
+      let i;
+      while ((i = b.indexOf("\n")) !== -1) {
+        const line = b.slice(0, i); b = b.slice(i + 1);
+        try {
+          const msg = JSON.parse(line);
+          if (msg.id !== undefined) {
+            process.stdout.write(JSON.stringify({
+              jsonrpc: "2.0", id: msg.id,
+              error: { code: -32000, message: "daemon not running — run: npx apple-voice-memos-mcp --setup" }
+            }) + "\n");
+          }
+        } catch (e) {}
+      }
+    });
+  }
+}
+
+const arg = process.argv[2];
+if (arg === "--setup" || arg === "-s") {
+  setup().catch((e) => { log("ERRORE: " + e.message); process.exit(1); });
+} else if (arg === "--status") {
+  status().catch((e) => { log("ERRORE: " + e.message); process.exit(1); });
+} else {
+  serveStdio();
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "apple-voice-memos-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Apple Voice Memos on macOS \u2014 zero-config npx, auto-setup with one-click Full Disk Access",
+  "bin": {
+    "apple-voice-memos-mcp": "bin/cli.js"
+  },
+  "main": "bin/cli.js",
+  "files": [
+    "bin/",
+    "src/"
+  ],
+  "keywords": [
+    "mcp",
+    "apple",
+    "voice-memos",
+    "macos",
+    "model-context-protocol",
+    "transcription"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^13.0.0",
+    "zod": "^3.25.0"
+  },
+  "overrides": {
+    "better-sqlite3": "^13.0.0"
+  },
+  "type": "module"
+}

package/src/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/src/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/src/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { VoiceMemoMCPServer } from "./server.js";
+async function main() {
+    const server = new VoiceMemoMCPServer();
+    // Handle graceful shutdown
+    process.on("SIGINT", () => {
+        server.close();
+        process.exit(0);
+    });
+    process.on("SIGTERM", () => {
+        server.close();
+        process.exit(0);
+    });
+    try {
+        await server.run();
+    }
+    catch (error) {
+        console.error("Fatal error:", error);
+        server.close();
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/src/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAExC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/src/dist/server.d.ts

@@ -0,0 +1,11 @@
+export declare class VoiceMemoMCPServer {
+    private server;
+    private db;
+    private transcriptExtractor;
+    private transcriptionService;
+    constructor();
+    private setupHandlers;
+    run(): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=server.d.ts.map

package/src/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAqCA,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,oBAAoB,CAAuB;;IAwBnD,OAAO,CAAC,aAAa;IAyEf,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1B,KAAK,IAAI,IAAI;CAGd"}

package/src/dist/server.js

@@ -0,0 +1,96 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { VoiceMemoDatabase } from "./services/voice-memo-db.js";
+import { TranscriptExtractor } from "./services/transcript-extractor.js";
+import { TranscriptionService } from "./services/transcription-service.js";
+import { listMemos, listMemosSchema, listMemosToolDefinition, } from "./tools/list-memos.js";
+import { getMemo, getMemoSchema, getMemoToolDefinition, } from "./tools/get-memo.js";
+import { getAudio, getAudioSchema, getAudioToolDefinition, } from "./tools/get-audio.js";
+import { getTranscript, getTranscriptSchema, getTranscriptToolDefinition, } from "./tools/get-transcript.js";
+import { transcribeMemo, transcribeSchema, transcribeToolDefinition, } from "./tools/transcribe.js";
+export class VoiceMemoMCPServer {
+    server;
+    db;
+    transcriptExtractor;
+    transcriptionService;
+    constructor() {
+        this.server = new Server({
+            name: "apple-voice-memo-mcp",
+            version: "0.1.0",
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.db = new VoiceMemoDatabase();
+        this.transcriptExtractor = new TranscriptExtractor();
+        this.transcriptionService = new TranscriptionService(process.env.VOICE_MEMO_TRANSCRIBER_PATH);
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                listMemosToolDefinition,
+                getMemoToolDefinition,
+                getAudioToolDefinition,
+                getTranscriptToolDefinition,
+                transcribeToolDefinition,
+            ],
+        }));
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case "list_voice_memos": {
+                        const input = listMemosSchema.parse(args);
+                        const result = await listMemos(input, this.db);
+                        return { content: [{ type: "text", text: result }] };
+                    }
+                    case "get_voice_memo": {
+                        const input = getMemoSchema.parse(args);
+                        const result = await getMemo(input, this.db);
+                        return { content: [{ type: "text", text: result }] };
+                    }
+                    case "get_audio": {
+                        const input = getAudioSchema.parse(args);
+                        const result = await getAudio(input, this.db);
+                        return { content: [{ type: "text", text: result }] };
+                    }
+                    case "get_transcript": {
+                        const input = getTranscriptSchema.parse(args);
+                        const result = await getTranscript(input, this.db, this.transcriptExtractor);
+                        return { content: [{ type: "text", text: result }] };
+                    }
+                    case "transcribe_memo": {
+                        const input = transcribeSchema.parse(args);
+                        const result = await transcribeMemo(input, this.db, this.transcriptionService);
+                        return { content: [{ type: "text", text: result }] };
+                    }
+                    default:
+                        return {
+                            content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                            isError: true,
+                        };
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+                return {
+                    content: [{ type: "text", text: `Error: ${errorMessage}` }],
+                    isError: true,
+                };
+            }
+        });
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=server.js.map

package/src/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/src/dist/services/transcript-extractor.d.ts

@@ -0,0 +1,6 @@
+import type { Transcript } from "../types/index.js";
+export declare class TranscriptExtractor {
+    extractTranscript(memoPath: string, format?: "text" | "json" | "timestamped"): Transcript | null;
+    extractTranscriptById(memoId: number, memoPath: string, format?: "text" | "json" | "timestamped"): Transcript | null;
+}
+//# sourceMappingURL=transcript-extractor.d.ts.map

package/src/dist/services/transcript-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-extractor.d.ts","sourceRoot":"","sources":["../../src/services/transcript-extractor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,mBAAmB;IAC9B,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAM,GAAG,MAAM,GAAG,aAAsB,GAC/C,UAAU,GAAG,IAAI;IA4BpB,qBAAqB,CACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAM,GAAG,MAAM,GAAG,aAAsB,GAC/C,UAAU,GAAG,IAAI;CAGrB"}

package/src/dist/services/transcript-extractor.js

@@ -0,0 +1,28 @@
+import { getAudioFilePath } from "../utils/paths.js";
+import { extractTsrpAtom, parseTsrpToText, parseTsrpToSegments, } from "../utils/mp4-parser.js";
+export class TranscriptExtractor {
+    extractTranscript(memoPath, format = "text") {
+        const fullPath = getAudioFilePath(memoPath);
+        if (!fullPath) {
+            return null;
+        }
+        const tsrpData = extractTsrpAtom(fullPath);
+        if (!tsrpData) {
+            return null;
+        }
+        const text = parseTsrpToText(tsrpData);
+        const locale = tsrpData.locale?.identifier || "unknown";
+        if (format === "text") {
+            return { text, locale };
+        }
+        if (format === "timestamped" || format === "json") {
+            const segments = parseTsrpToSegments(tsrpData);
+            return { text, segments, locale };
+        }
+        return { text, locale };
+    }
+    extractTranscriptById(memoId, memoPath, format = "text") {
+        return this.extractTranscript(memoPath, format);
+    }
+}
+//# sourceMappingURL=transcript-extractor.js.map

package/src/dist/services/transcript-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-extractor.js","sourceRoot":"","sources":["../../src/services/transcript-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,MAAM,OAAO,mBAAmB;IAC9B,iBAAiB,CACf,QAAgB,EAChB,SAA0C,MAAM;QAEhD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAE5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,IAAI,SAAS,CAAC;QAExD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,MAAM,KAAK,aAAa,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAC/C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,qBAAqB,CACnB,MAAc,EACd,QAAgB,EAChB,SAA0C,MAAM;QAEhD,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;CACF"}

package/src/dist/services/transcription-service.d.ts

@@ -0,0 +1,16 @@
+import type { TranscriptionResult } from "../types/index.js";
+/**
+ * Service for transcribing audio files using Apple's SFSpeechRecognizer.
+ *
+ * This requires a Swift helper CLI tool to be built and available.
+ * The helper uses SFSpeechRecognizer which requires:
+ * 1. Speech Recognition permission granted
+ * 2. Language packs downloaded via System Settings > Accessibility > Voice Control
+ */
+export declare class TranscriptionService {
+    private swiftHelperPath;
+    constructor(swiftHelperPath?: string);
+    transcribe(memoPath: string, language?: string): Promise<TranscriptionResult>;
+    private runSwiftTranscriber;
+}
+//# sourceMappingURL=transcription-service.d.ts.map