minutes-mcp 0.5.0 → 0.5.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mat Silverstein
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -31,6 +31,7 @@ import { readFile } from "fs/promises";
 import { dirname, extname, join, resolve } from "path";
 import { fileURLToPath } from "url";
 import { homedir } from "os";
+import * as reader from "minutes-sdk";
 const UI_RESOURCE_URI = "ui://minutes/dashboard";
 const execFileAsync = promisify(execFile);
 // ── QMD semantic search (optional — falls back to CLI) ──────
@@ -59,16 +60,14 @@ async function isQmdAvailable() {
 }
 async function enrichWithFrontmatter(qmdResults) {
     return Promise.all(qmdResults.map(async (r) => {
+        const filePath = r.source_path || r.path;
         try {
-            const head = (await readFile(r.source_path || r.path, "utf-8")).slice(0, 600);
-            const title = head.match(/^title:\s*(.+)$/m)?.[1]?.trim() || "";
-            const date = head.match(/^date:\s*(.+)$/m)?.[1]?.trim() || "";
-            const contentType = head.match(/^type:\s*(.+)$/m)?.[1]?.trim() || "meeting";
+            const meeting = await reader.getMeeting(filePath);
             return {
-                date,
-                title,
-                content_type: contentType,
-                path: r.source_path || r.path,
+                date: meeting?.frontmatter.date || "",
+                title: meeting?.frontmatter.title || "",
+                content_type: meeting?.frontmatter.type || "meeting",
+                path: filePath,
                 snippet: r.snippet || "",
             };
         }
@@ -77,7 +76,7 @@ async function enrichWithFrontmatter(qmdResults) {
                 date: "",
                 title: "",
                 content_type: "meeting",
-                path: r.source_path || r.path,
+                path: filePath,
                 snippet: r.snippet || "",
             };
         }
@@ -141,6 +140,36 @@ function findMinutesBinary() {
     return "minutes";
 }
 const MINUTES_BIN = findMinutesBinary();
+// ── CLI availability detection ──────────────────────────────
+// When installed via `npx minutes-mcp`, the Rust CLI may not be present.
+// In that case, read-only tools use the pure-TS reader module.
+let cliAvailable = null;
+let cliCheckedAt = 0;
+const CLI_CACHE_TTL_MS = 5 * 60 * 1000; // re-check every 5 minutes
+async function isCliAvailable() {
+    // Cache hit: return true permanently (CLI won't disappear mid-session)
+    // Cache miss (false): re-probe after TTL so installing CLI mid-session works
+    if (cliAvailable === true)
+        return true;
+    if (cliAvailable === false && Date.now() - cliCheckedAt < CLI_CACHE_TTL_MS)
+        return false;
+    try {
+        await execFileAsync(MINUTES_BIN, ["--version"], { timeout: 5000 });
+        cliAvailable = true;
+        cliCheckedAt = Date.now();
+        console.error("[Minutes] CLI found — full mode (all tools enabled)");
+    }
+    catch {
+        cliAvailable = false;
+        cliCheckedAt = Date.now();
+        console.error("[Minutes] CLI not found — read-only mode. Install for recording: brew install minutes");
+    }
+    return cliAvailable;
+}
+const CLI_INSTALL_MSG = "Recording requires the minutes CLI binary. Install it:\n" +
+    "  macOS:   brew tap silverstein/tap && brew install minutes\n" +
+    "  Any:     cargo install minutes-cli\n" +
+    "  Source:  https://github.com/silverstein/minutes";
 // ── Helper: run minutes CLI command (uses execFile, not exec) ──
 async function runMinutes(args, timeoutMs = 30000) {
     try {
@@ -208,7 +237,7 @@ function validatePathInDirectories(path, roots, allowedExts) {
 // ── MCP Server ──────────────────────────────────────────────
 const server = new McpServer({
     name: "minutes",
-    version: "0.3.0",
+    version: "0.5.2",
 });
 // Configurable directories — override via env vars in Claude Desktop extension settings
 const MEETINGS_DIR = process.env.MEETINGS_DIR || join(homedir(), "meetings");
@@ -234,6 +263,9 @@ server.tool("start_recording", "Start recording audio from the default input dev
         .default("meeting")
         .describe("Live capture mode"),
 }, { title: "Start Recording", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ title, mode }) => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
+    }
     const { stdout: statusOut } = await runMinutes(["status"]);
     const status = parseJsonOutput(statusOut);
     if (status.recording) {
@@ -274,6 +306,9 @@ server.tool("start_recording", "Start recording audio from the default input dev
 });
 // ── Tool: stop_recording ────────────────────────────────────
 server.tool("stop_recording", "Stop the current recording and process it (transcribe, diarize, summarize).", {}, { title: "Stop Recording", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async () => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
+    }
     try {
         const { stdout, stderr } = await runMinutes(["stop"], 180000);
         const result = parseJsonOutput(stdout);
@@ -293,6 +328,9 @@ server.tool("stop_recording", "Stop the current recording and process it (transc
 });
 // ── Tool: get_status ────────────────────────────────────────
 server.tool("get_status", "Check if a recording is currently in progress.", {}, { title: "Recording Status", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async () => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: `No recording in progress (read-only mode).\n\n${CLI_INSTALL_MSG}` }] };
+    }
     const { stdout } = await runMinutes(["status"]);
     const status = parseJsonOutput(stdout);
     const modeLabel = status.recording_mode === "quick-thought" ? "Quick thought" : "Recording";
@@ -314,6 +352,36 @@ registerAppTool(server, "list_meetings", {
     annotations: { title: "List Meetings", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     _meta: { ui: { resourceUri: UI_RESOURCE_URI } },
 }, async ({ limit, type: contentType }) => {
+    // Pure-TS fallback when CLI is not available
+    if (!(await isCliAvailable())) {
+        const meetings = await reader.listMeetings(MEETINGS_DIR, limit);
+        const filtered = contentType
+            ? meetings.filter((m) => m.frontmatter.type === contentType)
+            : meetings;
+        const openActions = await reader.findOpenActions(MEETINGS_DIR);
+        if (filtered.length === 0) {
+            return {
+                content: [{ type: "text", text: "No meetings or memos found." }],
+                structuredContent: { meetings: [], actions: [], view: "dashboard" },
+                _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "dashboard" },
+            };
+        }
+        const text = filtered
+            .map((m) => `${m.frontmatter.date} — ${m.frontmatter.title} [${m.frontmatter.type}]\n  ${m.path}`)
+            .join("\n\n");
+        const meetingsJson = filtered.map((m) => ({
+            date: m.frontmatter.date,
+            title: m.frontmatter.title,
+            content_type: m.frontmatter.type,
+            path: m.path,
+            duration: m.frontmatter.duration,
+        }));
+        return {
+            content: [{ type: "text", text }],
+            structuredContent: { meetings: meetingsJson, actions: openActions.map((a) => a.item), view: "dashboard" },
+            _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "dashboard" },
+        };
+    }
     const args = ["list", "--limit", String(limit)];
     if (contentType)
         args.push("-t", contentType);
@@ -367,6 +435,40 @@ registerAppTool(server, "search_meetings", {
     annotations: { title: "Search Meetings", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     _meta: { ui: { resourceUri: UI_RESOURCE_URI } },
 }, async ({ query, type: contentType, since, limit, intent_kind, owner, intents_only }) => {
+    // Pure-TS fallback when CLI is not available
+    if (!(await isCliAvailable())) {
+        const droppedFilters = [since && "since", intent_kind && "intent_kind", owner && "owner", intents_only && "intents_only"].filter(Boolean);
+        const filterWarning = droppedFilters.length > 0
+            ? `\n\n(Note: ${droppedFilters.join(", ")} filters require the CLI. Install: brew install minutes)`
+            : "";
+        const results = await reader.searchMeetings(MEETINGS_DIR, query, limit);
+        const filtered = contentType
+            ? results.filter((m) => m.frontmatter.type === contentType)
+            : results;
+        if (filtered.length === 0) {
+            return {
+                content: [{ type: "text", text: `No results for "${query}".${filterWarning}` }],
+                structuredContent: { results: [], view: "search" },
+                _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "search" },
+            };
+        }
+        const text = filtered
+            .map((m) => `${m.frontmatter.date} — ${m.frontmatter.title} [${m.frontmatter.type}]\n  ${m.path}`)
+            .join("\n\n") + filterWarning;
+        return {
+            content: [{ type: "text", text }],
+            structuredContent: {
+                results: filtered.map((m) => ({
+                    date: m.frontmatter.date,
+                    title: m.frontmatter.title,
+                    content_type: m.frontmatter.type,
+                    path: m.path,
+                })),
+                view: "search",
+            },
+            _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "search" },
+        };
+    }
     // Intent/metadata queries always use CLI (QMD doesn't index YAML frontmatter fields)
     const useCliOnly = intents_only || intent_kind || owner || since;
     // Try QMD semantic search for text queries
@@ -436,6 +538,9 @@ registerAppTool(server, "consistency_report", {
     annotations: { title: "Consistency Report", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     _meta: { ui: { resourceUri: UI_RESOURCE_URI } },
 }, async ({ owner, stale_after_days }) => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: `Consistency reports require the full CLI for structured intent analysis.\n\n${CLI_INSTALL_MSG}` }] };
+    }
     const args = ["consistency", "--stale-after-days", String(stale_after_days)];
     if (owner)
         args.push("--owner", owner);
@@ -485,6 +590,25 @@ registerAppTool(server, "get_person_profile", {
     annotations: { title: "Person Profile", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     _meta: { ui: { resourceUri: UI_RESOURCE_URI } },
 }, async ({ name }) => {
+    // Pure-TS fallback when CLI is not available
+    if (!(await isCliAvailable())) {
+        const profile = await reader.getPersonProfile(MEETINGS_DIR, name);
+        const sections = [];
+        if (profile.topics.length > 0)
+            sections.push("Topics: " + profile.topics.join(", "));
+        if (profile.meetings.length > 0) {
+            sections.push("Meetings:\n" + profile.meetings.map((m) => `- ${m.date} — ${m.title}`).join("\n"));
+        }
+        if (profile.openActions.length > 0) {
+            sections.push("Open actions:\n" + profile.openActions.map((a) => `- ${a.task} (${a.status})`).join("\n"));
+        }
+        const text = sections.length > 0 ? sections.join("\n\n") : `No profile data found for ${name}.`;
+        return {
+            content: [{ type: "text", text }],
+            structuredContent: { name, top_topics: profile.topics.map((t) => ({ topic: t, count: 1 })), open_intents: profile.openActions, recent_meetings: profile.meetings, view: "person" },
+            _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "person" },
+        };
+    }
     const { stdout, stderr } = await runMinutes(["person", name]);
     const profile = parseJsonOutput(stdout);
     if (!profile || typeof profile !== "object") {
@@ -537,6 +661,15 @@ server.tool("research_topic", "Research a topic across meetings, decisions, and
     since: z.string().optional().describe("Only results after this date (ISO)"),
     attendee: z.string().optional().describe("Filter by attendee / person"),
 }, { title: "Research Topic", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ query, type: contentType, since, attendee }) => {
+    if (!(await isCliAvailable())) {
+        // Fallback: basic search when CLI is not available
+        const results = await reader.searchMeetings(MEETINGS_DIR, query, 20);
+        const filtered = contentType ? results.filter((m) => m.frontmatter.type === contentType) : results;
+        const text = filtered.length > 0
+            ? filtered.map((m) => `${m.frontmatter.date} — ${m.frontmatter.title}\n  ${m.path}`).join("\n\n")
+            : `No results for "${query}". (Note: advanced research features require the CLI.)`;
+        return { content: [{ type: "text", text }] };
+    }
     const args = ["research", query];
     if (contentType)
         args.push("-t", contentType);
@@ -629,6 +762,9 @@ server.tool("process_audio", "Process an audio file through the transcription pi
     type: z.enum(["meeting", "memo"]).optional().default("memo").describe("Content type"),
     title: z.string().optional().describe("Optional title"),
 }, { title: "Process Audio", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ file_path, type: contentType, title }) => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
+    }
     const allowedDirs = [
         join(MINUTES_HOME, "inbox"),
         MEETINGS_DIR,
@@ -667,6 +803,9 @@ server.tool("add_note", "Add a note to the current recording. Notes are timestam
         .optional()
         .describe("Path to an existing meeting file to annotate (for post-meeting notes)"),
 }, { title: "Add Note", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ text, meeting_path }) => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
+    }
     try {
         const args = ["note", text];
         if (meeting_path) {
@@ -775,31 +914,121 @@ server.tool("register_qmd_collection", "Register the Minutes output directory as
 });
 // ── Resources ───────────────────────────────────────────────
 server.resource("recent_meetings", "minutes://meetings/recent", { description: "List of recent meetings and memos" }, async () => {
+    if (!(await isCliAvailable())) {
+        const meetings = await reader.listMeetings(MEETINGS_DIR, 20);
+        const json = JSON.stringify(meetings.map((m) => ({
+            date: m.frontmatter.date, title: m.frontmatter.title,
+            content_type: m.frontmatter.type, path: m.path, duration: m.frontmatter.duration,
+        })));
+        return { contents: [{ uri: "minutes://meetings/recent", mimeType: "application/json", text: json }] };
+    }
     const { stdout } = await runMinutes(["list", "--limit", "20"]);
     return { contents: [{ uri: "minutes://meetings/recent", mimeType: "application/json", text: stdout }] };
 });
 server.resource("recording_status", "minutes://status", { description: "Current recording status" }, async () => {
+    if (!(await isCliAvailable())) {
+        return { contents: [{ uri: "minutes://status", mimeType: "application/json", text: JSON.stringify({ recording: false, processing: false, note: "Read-only mode (CLI not installed)" }) }] };
+    }
     const { stdout } = await runMinutes(["status"]);
     return { contents: [{ uri: "minutes://status", mimeType: "application/json", text: stdout }] };
 });
 server.resource("open_actions", "minutes://actions/open", { description: "All open action items across meetings" }, async () => {
+    if (!(await isCliAvailable())) {
+        const actions = await reader.findOpenActions(MEETINGS_DIR);
+        return { contents: [{ uri: "minutes://actions/open", mimeType: "application/json", text: JSON.stringify(actions) }] };
+    }
     const { stdout } = await runMinutes(["search", "", "--intents-only", "--intent-kind", "action-item"]);
     return { contents: [{ uri: "minutes://actions/open", mimeType: "application/json", text: stdout }] };
 });
 server.resource("recent_events", "minutes://events/recent", { description: "Recent pipeline events (recordings, processing, notes)" }, async () => {
+    if (!(await isCliAvailable())) {
+        return { contents: [{ uri: "minutes://events/recent", mimeType: "application/json", text: "[]" }] };
+    }
     const { stdout } = await runMinutes(["events", "--limit", "20"]);
     return { contents: [{ uri: "minutes://events/recent", mimeType: "application/json", text: stdout }] };
 });
 server.resource("meeting", new ResourceTemplate("minutes://meetings/{slug}", { list: undefined }), { description: "Get a specific meeting by its filename slug" }, async (uri, variables) => {
     const slug = String(variables.slug);
+    if (!(await isCliAvailable())) {
+        // Without CLI resolve, find by filename match
+        const meetings = await reader.listMeetings(MEETINGS_DIR, 1000);
+        const match = meetings.find((m) => m.path.includes(slug));
+        if (match) {
+            const content = await readFile(match.path, "utf-8");
+            return { contents: [{ uri: uri.href, mimeType: "text/markdown", text: content }] };
+        }
+        return { contents: [{ uri: uri.href, mimeType: "text/plain", text: `Meeting not found: ${slug}` }] };
+    }
     const { stdout } = await runMinutes(["resolve", slug]);
     const parsed = parseJsonOutput(stdout);
     if (parsed.path) {
-        const content = await readFile(parsed.path, "utf-8");
+        const validated = validatePathInDirectory(parsed.path, MEETINGS_DIR, [".md"]);
+        const content = await readFile(validated, "utf-8");
         return { contents: [{ uri: uri.href, mimeType: "text/markdown", text: content }] };
     }
     return { contents: [{ uri: uri.href, mimeType: "text/plain", text: `Meeting not found: ${slug}` }] };
 });
+// ── Tool: start_dictation ──────────────────────────────────
+server.tool("start_dictation", "Start dictation mode. Speak naturally — text goes to clipboard and daily note after each pause. Runs until stop_dictation is called or silence timeout.", {}, { title: "Start Dictation", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async () => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
+    }
+    const { stdout: statusOut } = await runMinutes(["status"]);
+    const status = parseJsonOutput(statusOut);
+    if (status.recording) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Recording in progress — stop recording before dictating.",
+                },
+            ],
+        };
+    }
+    // Spawn detached dictation process
+    const child = spawn(MINUTES_BIN, ["dictate"], {
+        detached: true,
+        stdio: "ignore",
+        env: { ...process.env, RUST_LOG: "info" },
+    });
+    child.unref();
+    // Wait briefly for startup
+    await new Promise((r) => setTimeout(r, 500));
+    return {
+        content: [
+            {
+                type: "text",
+                text: "Dictation started. Speak naturally — text will be copied to clipboard after each pause. Say \"stop dictation\" when done.",
+            },
+        ],
+    };
+});
+// ── Tool: stop_dictation ───────────────────────────────────
+server.tool("stop_dictation", "Stop the current dictation session.", {}, { title: "Stop Dictation", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async () => {
+    // Send stop signal by killing the dictation process via PID file
+    const minutesDir = join(homedir(), ".minutes");
+    const pidPath = join(minutesDir, "dictation.pid");
+    if (existsSync(pidPath)) {
+        try {
+            const pidContent = await readFile(pidPath, "utf-8");
+            const pid = parseInt(pidContent.trim(), 10);
+            if (Number.isFinite(pid) && pid > 0) {
+                process.kill(pid, "SIGTERM");
+            }
+        }
+        catch {
+            // Process already dead or PID file invalid
+        }
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: "Dictation stop requested.",
+            },
+        ],
+    };
+});
 // ── Start server ────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minutes-mcp",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "MCP server for minutes — conversation memory for AI assistants. Works with Claude Desktop, Cursor, Windsurf, and any MCP client.",
   "main": "dist/index.js",
   "type": "module",
@@ -9,7 +9,8 @@
   },
   "files": [
     "dist/",
-    "dist-ui/"
+    "dist-ui/",
+    "LICENSE"
   ],
   "keywords": [
     "mcp",
@@ -38,11 +39,11 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "minutes-sdk": "file:../sdk",
+    "@modelcontextprotocol/ext-apps": "^1.2.2",
+    "minutes-sdk": "^0.5.0",
     "yaml": "^2.8.3"
   },
   "devDependencies": {
-    "@modelcontextprotocol/ext-apps": "^1.2.2",
     "@types/node": "^22.0.0",
     "tsx": "^4.0.0",
     "typescript": "^5.5.0",