@plaud-ai/mcp 0.1.27 → 0.1.28

package/dist/chunk-ET3HYWAC.js

@@ -0,0 +1,134 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/skills.ts
+var SKILLS = [
+  {
+    name: "search-recordings",
+    description: "Search and filter Plaud recordings by date, tag, or keyword",
+    content: `## Plaud Skill: search-recordings
+
+When the user wants to find, browse, filter, or search their Plaud recordings, follow this workflow:
+
+1. Call \`list_files\` with the appropriate filters based on the user's request:
+   - \`from\` / \`to\` \u2014 ISO 8601 date range (e.g. \`2026-04-01T00:00:00Z\`)
+   - \`tag\` \u2014 filter by tag label
+   - \`workspace_id\` \u2014 filter by workspace
+   - \`limit\` \u2014 number of results to return
+2. Present results in a clear list: recording name, date, duration, and file ID
+3. If the user wants to narrow results, refine the filters and call again
+
+Do not fetch transcripts or notes unless the user explicitly asks to view the content of a specific recording.`
+  },
+  {
+    name: "extract-structured-data",
+    description: "Extract structured fields from a Plaud recording using a custom schema",
+    content: `## Plaud Skill: extract-structured-data
+
+When the user wants to extract specific fields or structured information from a recording, follow this workflow:
+
+1. If no recording is specified, call \`list_files\` and ask the user to identify the target
+2. Call \`get_note\` to retrieve the AI-generated summary, action items, and key topics
+3. Call \`get_transcript\` if the extraction requires full verbatim content
+4. Apply the user's schema or field list to the content and return the extracted data
+5. Present each field clearly; flag any fields where the content is ambiguous or absent
+
+Example schemas the user might request:
+- \`{ "action_items": [], "decisions": [], "attendees": [] }\`
+- \`{ "pain_points": [], "follow_ups": [], "deal_stage": "" }\`
+- \`{ "diagnoses": [], "medications": [], "next_appointment": "" }\``
+  },
+  {
+    name: "generate-artifact",
+    description: "Generate a document (email, summary, SOAP note, brief) grounded in a Plaud recording",
+    content: `## Plaud Skill: generate-artifact
+
+When the user wants to generate a document grounded in recording content, follow this workflow:
+
+1. Call \`get_note\` to retrieve AI-generated notes for the target recording
+2. Call \`get_transcript\` if the artifact requires verbatim quotes or precise detail
+3. Generate the artifact using the recording content as the source of truth
+4. Format the output to match the requested artifact type
+
+Common artifact types:
+- **Follow-up email** \u2014 summarize key points, list action items, professional tone
+- **Meeting summary** \u2014 attendees, decisions made, next steps
+- **SOAP note** \u2014 Subjective / Objective / Assessment / Plan format for clinical use
+- **Project brief** \u2014 background, goals, scope, timeline from a planning session
+- **Weekly digest** \u2014 highlights across multiple recordings from the past week`
+  },
+  {
+    name: "synthesize-corpus",
+    description: "Analyze trends and patterns across multiple Plaud recordings",
+    content: `## Plaud Skill: synthesize-corpus
+
+When the user wants to analyze patterns, trends, or themes across multiple recordings, follow this workflow:
+
+1. Call \`list_files\` with date or tag filters to identify the target set of recordings (max 50 per call)
+2. For each recording, call \`get_note\` to retrieve the AI-generated summary
+3. Call \`get_transcript\` only if deeper analysis requires full verbatim content from specific recordings
+4. Synthesize insights across all recordings:
+   - Recurring themes or topics
+   - Trends over time
+   - Consistent decisions or blockers
+   - Patterns in action items or follow-ups
+5. Present findings with references to specific recordings as supporting evidence
+
+Use date filters to scope the corpus (e.g., last week, last quarter, a specific project period).`
+  },
+  {
+    name: "push-to-destination",
+    description: "Send recording content or a generated artifact to Notion, HubSpot, Slack, Linear, or a webhook",
+    content: `## Plaud Skill: push-to-destination
+
+When the user wants to send recording content or a generated artifact to an external system, follow this workflow:
+
+1. Confirm what content to send: extracted data, a generated artifact, or raw notes
+2. Confirm the destination and any required identifiers:
+   - **Notion** \u2014 page ID or database ID
+   - **HubSpot / Salesforce** \u2014 CRM object ID (deal, contact, or company)
+   - **Linear** \u2014 project or team ID
+   - **Slack** \u2014 channel name or ID
+   - **Webhook** \u2014 URL provided by the user
+3. Deliver the content to the destination using the appropriate integration tool or API call available in your environment
+4. Confirm successful delivery to the user
+
+Note: Destination credentials (API tokens, webhook URLs) must be provided by the user. Do not store them in conversation history \u2014 use environment variables or the user's config.`
+  }
+];
+var SKILLS_COMBINED = SKILLS.map((s) => s.content).join("\n\n---\n\n");
+
+export {
+  __commonJS,
+  __export,
+  __toESM,
+  SKILLS,
+  SKILLS_COMBINED
+};

package/dist/index.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import {
+  SKILLS,
   __commonJS,
   __export,
   __toESM
-} from "./chunk-U67V476Y.js";
+} from "./chunk-ET3HYWAC.js";
 
 // ../../node_modules/.pnpm/ajv@8.18.0/node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
@@ -31019,29 +31020,34 @@ server.tool("logout", "Log out, sign out, revoke authorization, and disconnect f
     content: [{ type: "text", text: "Logged out and revoked authorization." }]
   };
 });
+for (const skill of SKILLS) {
+  server.prompt(skill.name, skill.description, () => ({
+    messages: [{ role: "user", content: { type: "text", text: skill.content } }]
+  }));
+}
 async function main() {
   if (process.argv[2] === "clean-plugin") {
-    const { runCleanPlugin } = await import("./setup-GXCN7XZE.js");
+    const { runCleanPlugin } = await import("./setup-V6NJ4XKN.js");
     await runCleanPlugin();
     return;
   }
   if (process.argv[2] === "setup" && process.argv[3] === "codex") {
-    const { runSetupCodex } = await import("./setup-GXCN7XZE.js");
+    const { runSetupCodex } = await import("./setup-V6NJ4XKN.js");
     await runSetupCodex();
     return;
   }
   if (process.argv[2] === "unsetup" && process.argv[3] === "codex") {
-    const { runUnsetupCodex } = await import("./setup-GXCN7XZE.js");
+    const { runUnsetupCodex } = await import("./setup-V6NJ4XKN.js");
     await runUnsetupCodex();
     return;
   }
   if (process.argv[2] === "setup") {
-    const { runSetup } = await import("./setup-GXCN7XZE.js");
+    const { runSetup } = await import("./setup-V6NJ4XKN.js");
     await runSetup();
     return;
   }
   if (process.argv[2] === "unsetup") {
-    const { runUnsetup } = await import("./setup-GXCN7XZE.js");
+    const { runUnsetup } = await import("./setup-V6NJ4XKN.js");
     await runUnsetup();
     return;
   }

package/dist/{setup-GXCN7XZE.js → setup-V6NJ4XKN.js}

@@ -1,10 +1,68 @@
-import "./chunk-U67V476Y.js";
+import {
+  SKILLS_COMBINED
+} from "./chunk-ET3HYWAC.js";
 
 // src/setup.ts
 import { readFile, writeFile, mkdir, rm } from "fs/promises";
 import { join, dirname } from "path";
-import { homedir } from "os";
+import { homedir, platform } from "os";
 import { fileURLToPath } from "url";
+import { spawnSync } from "child_process";
+var SKILLS_MARKER_START = "<!-- plaud-skills:start -->";
+var SKILLS_MARKER_END = "<!-- plaud-skills:end -->";
+var SKILLS_BLOCK = `${SKILLS_MARKER_START}
+${SKILLS_COMBINED}
+${SKILLS_MARKER_END}`;
+async function removeSkillsFromClaudeCode() {
+  const claudeMdPath = join(homedir(), ".claude", "CLAUDE.md");
+  let existing = "";
+  try {
+    existing = await readFile(claudeMdPath, "utf-8");
+  } catch {
+    return;
+  }
+  if (!existing.includes(SKILLS_MARKER_START)) {
+    return;
+  }
+  const updated = existing.replace(new RegExp(`\\n?${SKILLS_MARKER_START}[\\s\\S]*?${SKILLS_MARKER_END}\\n?`), "").trimEnd();
+  await writeFile(claudeMdPath, updated ? updated + "\n" : "", "utf-8");
+}
+async function writeSkillsToClaudeCode() {
+  const claudeMdPath = join(homedir(), ".claude", "CLAUDE.md");
+  let existing = "";
+  try {
+    existing = await readFile(claudeMdPath, "utf-8");
+  } catch {
+  }
+  if (existing.includes(SKILLS_MARKER_START)) {
+    const updated = existing.replace(
+      new RegExp(`${SKILLS_MARKER_START}[\\s\\S]*?${SKILLS_MARKER_END}`),
+      SKILLS_BLOCK
+    );
+    await mkdir(dirname(claudeMdPath), { recursive: true });
+    await writeFile(claudeMdPath, updated, "utf-8");
+  } else {
+    await mkdir(dirname(claudeMdPath), { recursive: true });
+    await writeFile(claudeMdPath, existing + (existing.endsWith("\n") ? "" : "\n") + SKILLS_BLOCK + "\n", "utf-8");
+  }
+}
+function copyToClipboard(content) {
+  const cmd = platform() === "win32" ? "clip" : "pbcopy";
+  const result = spawnSync(cmd, [], { input: content });
+  return result.status === 0;
+}
+function printSkillsPasteGuide() {
+  const copied = copyToClipboard(SKILLS_COMBINED);
+  console.log("");
+  if (copied) {
+    console.log("Plaud Skills copied to clipboard.");
+  } else {
+    console.log("Could not copy to clipboard automatically.");
+  }
+  console.log("Paste into your client's custom instructions to enable Plaud Skills:");
+  console.log("  Claude Desktop: Settings \u2192 Profile \u2192 Custom Instructions");
+  console.log("  Codex Desktop:  refer to client documentation");
+}
 function getMcpEntry() {
   const __dirname = dirname(fileURLToPath(import.meta.url));
   return {
@@ -66,6 +124,9 @@ args = ["${args[0]}"]
   await writeFile(configPath, content + entry, "utf-8");
   console.log("Plaud has been added to Codex Desktop.");
   console.log("Please restart Codex Desktop to complete the setup.");
+  await writeSkillsToClaudeCode();
+  console.log("Plaud Skills have been added to ~/.claude/CLAUDE.md for Claude Code.");
+  printSkillsPasteGuide();
   process.exit(0);
 }
 async function runUnsetupCodex() {
@@ -83,6 +144,7 @@ async function runUnsetupCodex() {
   }
   const cleaned = content.replace(/\n*\[mcp_servers\.plaud\]\n(?:(?!\[)[^\n]*\n)*/g, "");
   await writeFile(configPath, cleaned, "utf-8");
+  await removeSkillsFromClaudeCode();
   console.log("Plaud has been removed from Codex Desktop.");
   console.log("Please restart Codex Desktop to complete the unsetup.");
   process.exit(0);
@@ -109,6 +171,7 @@ async function runUnsetup() {
   const { plaud: _, ...rest } = mcpServers;
   config.mcpServers = rest;
   await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+  await removeSkillsFromClaudeCode();
   console.log("Plaud has been removed from Claude Desktop.");
   console.log("Please restart Claude Desktop to complete the unsetup.");
   process.exit(0);
@@ -136,6 +199,9 @@ async function runSetup() {
   await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
   console.log("Plaud has been added to Claude Desktop.");
   console.log("Please restart Claude Desktop to complete the setup.");
+  await writeSkillsToClaudeCode();
+  console.log("Plaud Skills have been added to ~/.claude/CLAUDE.md for Claude Code.");
+  printSkillsPasteGuide();
   process.exit(0);
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaud-ai/mcp",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "plaud",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "description": "Access your Plaud recordings in Claude",
   "author": {
     "name": "Plaud AI"

package/skills/plaud/SKILL.md

@@ -13,7 +13,9 @@ You have access to the user's Plaud recordings via MCP tools. Use them to help t
 | `logout` | User wants to sign out or disconnect |
 | `get_current_user` | User asks who is logged in, or to verify account |
 | `list_files` | User wants to browse, search, or find recordings |
-| `get_file` | User wants details, transcript, or summary of a specific recording |
+| `get_file` | User wants full details of a specific recording (including download link) |
+| `get_note` | User wants the AI-generated summary, action items, or key topics of a recording |
+| `get_transcript` | User wants the full timestamped transcript with speaker labels |
 
 ## Typical workflows
 
@@ -21,7 +23,11 @@ You have access to the user's Plaud recordings via MCP tools. Use them to help t
 
 **Find a recording:** Call `list_files` to browse. Use pagination (`page`, `page_size`) if the user wants more results.
 
-**Review a recording:** Call `get_file` with the file ID. The response includes:
+**Review notes or summary:** Call `get_note` with the file ID.
+
+**Read transcript:** Call `get_transcript` with the file ID.
+
+**Get full details (including download link):** Call `get_file` with the file ID. The response includes:
 - `source_list`: timestamped transcript with speaker labels
 - `note_list`: AI-generated summaries in Markdown
 - `presigned_url`: temporary download link (valid 24 hours)

package/dist/chunk-U67V476Y.js

@@ -1,35 +0,0 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
-export {
-  __commonJS,
-  __export,
-  __toESM
-};