omni-notify-mcp 1.1.4 → 1.1.6

package/README.md

@@ -86,7 +86,7 @@ Priority routing for `notify`:
 ## Features
 
 ### Channels
-- **Desktop** — native `node-notifier` (macOS/Windows/Linux). Per-channel **system-sound toggle**.
+- **Desktop** — native `node-notifier` (macOS/Windows/Linux). Per-channel **system-sound toggle** and optional **text-to-speech** with a voice picker covering 30+ neural voices (US/UK/AU/CA/IN/IE/NZ/…) via `msedge-tts`, no API key.
 - **Telegram** — bidirectional. The bot **replies in-thread** to user messages and acknowledges every inbound message so the user knows it landed.
 - **SMS** — Twilio.
 - **Email** — Gmail App Password (one click) or any SMTP. `ask` over email sends a reply link the user clicks to answer.

package/dist/channels/desktop.js

@@ -1,5 +1,8 @@
 import notifier from "node-notifier";
 import { spawn } from "child_process";
+import { tmpdir } from "os";
+import { join } from "path";
+const DEFAULT_TTS_VOICE = "en-US-AndrewMultilingualNeural";
 export async function sendDesktop(config, message) {
     if (!config.enabled)
         return;
@@ -12,7 +15,34 @@ export async function sendDesktop(config, message) {
             "Add-Type -AssemblyName System.Windows.Forms; [System.Media.SystemSounds]::Asterisk.Play(); Start-Sleep -Milliseconds 600",
         ], { windowsHide: true, stdio: "ignore" });
     }
+    if (config.tts) {
+        // Fire-and-forget: synthesize and play in the background so we don't
+        // block the MCP request on network + audio playback.
+        speak(message, config.ttsVoice ?? DEFAULT_TTS_VOICE).catch(() => { });
+    }
     await new Promise((resolve, reject) => {
         notifier.notify({ title: "Claude", message, sound: wantSound && process.platform !== "win32" }, (err) => err ? reject(err) : resolve());
     });
 }
+export async function speak(text, voice = DEFAULT_TTS_VOICE) {
+    // Lazy import so boot doesn't pay for msedge-tts when TTS is off.
+    const mod = await import("msedge-tts");
+    const { MsEdgeTTS, OUTPUT_FORMAT } = mod;
+    const tts = new MsEdgeTTS();
+    await tts.setMetadata(voice, OUTPUT_FORMAT.AUDIO_24KHZ_48KBITRATE_MONO_MP3);
+    const { mkdtempSync } = await import("fs");
+    const outDir = mkdtempSync(join(tmpdir(), "notify-tts-"));
+    const { audioFilePath } = await tts.toFile(outDir, text);
+    if (process.platform === "win32") {
+        spawn("powershell", [
+            "-NoProfile", "-Command",
+            `Add-Type -AssemblyName presentationCore; $p = New-Object System.Windows.Media.MediaPlayer; $p.Open([uri]'${audioFilePath.replace(/\\/g, "\\\\")}'); $p.Play(); Start-Sleep -Seconds 10`,
+        ], { windowsHide: true, stdio: "ignore" });
+    }
+    else if (process.platform === "darwin") {
+        spawn("afplay", [audioFilePath], { stdio: "ignore" });
+    }
+    else {
+        spawn("aplay", [audioFilePath], { stdio: "ignore" });
+    }
+}

package/dist/ui/server.js

@@ -13,6 +13,7 @@ import twilio from "twilio";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { z } from "zod";
+import { tmpdir } from "os";
 const PORT = process.env.PORT ? parseInt(process.env.PORT) : 3737;
 const REDIRECT_URI = `http://localhost:${PORT}/auth/google/callback`;
 const PUBLIC_DIR = join(fileURLToPath(new URL("../../ui/public", import.meta.url)));
@@ -168,6 +169,60 @@ app.post("/api/test/sound", (_req, res) => {
             res.json({ ok: true, message: "System sound triggered" });
     });
 });
+async function speakText(text, voice) {
+    const mod = await import("msedge-tts");
+    const { MsEdgeTTS, OUTPUT_FORMAT } = mod;
+    const tts = new MsEdgeTTS();
+    await tts.setMetadata(voice, OUTPUT_FORMAT.AUDIO_24KHZ_48KBITRATE_MONO_MP3);
+    const { mkdtempSync } = await import("fs");
+    const outDir = mkdtempSync(join(tmpdir(), "notify-tts-"));
+    const { audioFilePath } = await tts.toFile(outDir, text);
+    if (process.platform === "win32") {
+        spawn("powershell", [
+            "-NoProfile", "-Command",
+            `Add-Type -AssemblyName presentationCore; $p = New-Object System.Windows.Media.MediaPlayer; $p.Open([uri]'${audioFilePath.replace(/\\/g, "\\\\")}'); $p.Play(); Start-Sleep -Seconds 10`,
+        ], { windowsHide: true, stdio: "ignore" });
+    }
+    else if (process.platform === "darwin") {
+        spawn("afplay", [audioFilePath], { stdio: "ignore" });
+    }
+    else {
+        spawn("aplay", [audioFilePath], { stdio: "ignore" });
+    }
+}
+app.post("/api/test/tts", async (req, res) => {
+    try {
+        const cfg = loadConfig();
+        const voice = (typeof req.body?.voice === "string" && req.body.voice) ||
+            cfg.desktop?.ttsVoice ||
+            "en-US-AndrewMultilingualNeural";
+        await speakText("Notification from Claude. This is a voice test.", voice);
+        res.json({ ok: true, message: `TTS played (${voice})` });
+    }
+    catch (err) {
+        res.status(500).json({ error: err instanceof Error ? err.message : String(err) });
+    }
+});
+let voiceCache = null;
+app.get("/api/voices", async (_req, res) => {
+    try {
+        if (!voiceCache || Date.now() - voiceCache.ts > 24 * 60 * 60 * 1000) {
+            const mod = await import("msedge-tts");
+            const tts = new mod.MsEdgeTTS();
+            const all = await tts.getVoices();
+            voiceCache = {
+                ts: Date.now(),
+                voices: all
+                    .filter((v) => v.Locale.startsWith("en-") && v.ShortName.includes("Neural"))
+                    .map((v) => ({ shortName: v.ShortName, gender: v.Gender, locale: v.Locale })),
+            };
+        }
+        res.json({ voices: voiceCache.voices });
+    }
+    catch (err) {
+        res.status(500).json({ error: err instanceof Error ? err.message : String(err) });
+    }
+});
 app.post("/api/test/desktop", (_req, res) => {
     const time = new Date().toLocaleTimeString();
     const cfg = loadConfig();
@@ -568,6 +623,10 @@ async function sendNotification(message, priority, client) {
                 ], { windowsHide: true, stdio: "ignore" });
             }
             const soundOpt = wantSound && process.platform !== "win32";
+            if (cfg.desktop?.tts) {
+                const voice = cfg.desktop?.ttsVoice ?? "en-US-AndrewMultilingualNeural";
+                speakText(message, voice).catch((err) => log("→", "tts", `ERROR: ${err instanceof Error ? err.message : String(err)}`, client));
+            }
             await send("desktop", () => new Promise((res, rej) => notifier.notify({ title: "Claude Notify", message, sound: soundOpt }, (err) => err ? rej(err) : res())));
         }
         if (!desktopOnlyMode && cfg.telegram?.enabled && cfg.telegram.token && cfg.telegram.chatId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-notify-mcp",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "An MCP server that lets AI agents (Claude, Cursor, etc.) reach you on any channel — desktop, Telegram, SMS, email — with two-way ask/reply, real-time inbox push, Do Not Disturb, idle gating, multi-session routing, and a one-page web UI for setup. Zero config code; configure once, agents call notify/ask.",
   "main": "dist/index.js",
   "type": "module",
@@ -53,6 +53,7 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "express": "^4.19.2",
     "googleapis": "^144.0.0",
+    "msedge-tts": "^2.0.5",
     "node-notifier": "^10.0.1",
     "nodemailer": "^6.9.9",
     "open": "^10.1.0",

package/ui/public/app.js

@@ -44,6 +44,9 @@ function populateForm() {
   // Desktop
   $("desktop-enabled").checked = !!config.desktop?.enabled;
   $("desktop-sound").checked = config.desktop?.sound !== false; // default on
+  $("desktop-tts").checked = !!config.desktop?.tts; // default off
+  updateTtsVoiceRow();
+  loadVoices().catch(() => {});
 
   // Email / Gmail
   const email = config.email ?? {};
@@ -150,14 +153,49 @@ function setBadge(channel, type, text) {
 // ── Save handlers ─────────────────────────────────────────────────────────
 
 function saveDesktop() {
+  updateTtsVoiceRow();
+  const ttsVoice = $("desktop-tts-voice").value || undefined;
   patch({
     desktop: {
       enabled: $("desktop-enabled").checked,
       sound: $("desktop-sound").checked,
+      tts: $("desktop-tts").checked,
+      ttsVoice,
     },
   });
 }
 
+function updateTtsVoiceRow() {
+  const row = $("tts-voice-row");
+  row.style.display = $("desktop-tts").checked ? "" : "none";
+}
+
+let voicesLoaded = false;
+async function loadVoices() {
+  if (voicesLoaded) return;
+  const res = await fetch("/api/voices");
+  if (!res.ok) return;
+  const { voices } = await res.json();
+  const sel = $("desktop-tts-voice");
+  const current = config.desktop?.ttsVoice || "en-US-AndrewMultilingualNeural";
+  const byLocale = {};
+  for (const v of voices) (byLocale[v.locale] ??= []).push(v);
+  sel.innerHTML = "";
+  for (const locale of Object.keys(byLocale).sort()) {
+    const og = document.createElement("optgroup");
+    og.label = locale;
+    for (const v of byLocale[locale].sort((a, b) => a.shortName.localeCompare(b.shortName))) {
+      const opt = document.createElement("option");
+      opt.value = v.shortName;
+      opt.textContent = `${v.shortName.replace(locale + "-", "")} (${v.gender})`;
+      if (v.shortName === current) opt.selected = true;
+      og.appendChild(opt);
+    }
+    sel.appendChild(og);
+  }
+  voicesLoaded = true;
+}
+
 async function saveEmail() {
   const to = $("gmail-to-connected").value.trim();
   const enabled = $("email-enabled").checked;
@@ -398,6 +436,22 @@ async function testSound() {
   }
 }
 
+async function testTts() {
+  try {
+    const voice = $("desktop-tts-voice").value || undefined;
+    const res = await fetch("/api/test/tts", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ voice }),
+    });
+    const json = await res.json();
+    if (!res.ok) throw new Error(json.error);
+    toast(json.message, "ok");
+  } catch (e) {
+    toast("TTS test failed: " + e, "error");
+  }
+}
+
 // ── Test channels ─────────────────────────────────────────────────────────
 
 async function testChannel(channel) {

package/ui/public/index.html

@@ -55,6 +55,17 @@
             <span class="toggle-lbl">Play system sound</span>
             <button class="btn btn-sm btn-ghost" onclick="testSound()">Test sound</button>
           </div>
+          <div class="actions" style="margin-top:6px">
+            <label class="toggle-wrap">
+              <input type="checkbox" id="desktop-tts" onchange="saveDesktop()">
+              <span class="toggle"></span>
+            </label>
+            <span class="toggle-lbl">Speak notification</span>
+            <button class="btn btn-sm btn-ghost" onclick="testTts()">Test voice</button>
+          </div>
+          <div id="tts-voice-row" class="actions" style="margin-top:6px; display:none">
+            <select id="desktop-tts-voice" onchange="saveDesktop()" style="flex:1; min-width:0"></select>
+          </div>
           <span id="os-hint" class="os-tag hidden"></span>
         </div>
       </div>