@gethmy/mcp 2.9.2 → 2.9.4

package/dist/cli.js

@@ -695,6 +695,10 @@ function getMemoryDir() {
     return config.memoryDir;
   return join(homedir(), ".harmony", "memory");
 }
+
+// src/server.ts
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
 // ../memory/dist/sync.js
 import { createHash } from "node:crypto";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
@@ -1523,6 +1527,9 @@ class HarmonyApiClient {
   async getCardAttachments(cardId) {
     return this.request("GET", `/cards/${cardId}/attachments`);
   }
+  async uploadCardAttachment(cardId, data) {
+    return this.request("POST", `/cards/${cardId}/attachments`, data);
+  }
   async getCardExternalLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }
@@ -3485,6 +3492,32 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_upload_card_attachment: {
+    description: "Upload a file attachment to a card (e.g. a pasted screenshot or a document). Provide the file either as `filePath` (a local path the MCP server can read — works in local/stdio mode) or as `base64Data` (raw base64 bytes — works everywhere, including remote mode). Max 5MB. Allowed: PNG, JPEG, GIF, WebP, HEIC/HEIF, PDF, DOC/DOCX, XLS/XLSX, TXT. Returns the stored attachment with a short-lived signed URL.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID" },
+        filePath: {
+          type: "string",
+          description: "Absolute path to a local file the MCP server process can read. Mutually exclusive with base64Data."
+        },
+        base64Data: {
+          type: "string",
+          description: "Base64-encoded file bytes (a `data:` URL prefix is accepted and stripped). Requires fileName. Mutually exclusive with filePath."
+        },
+        fileName: {
+          type: "string",
+          description: "File name including extension (e.g. 'screenshot.png'). Required with base64Data; defaults to the basename of filePath otherwise."
+        },
+        contentType: {
+          type: "string",
+          description: "Optional MIME type (e.g. 'image/png'). Inferred from the file extension when omitted."
+        }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_get_card_external_links: {
     description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
     inputSchema: {
@@ -4903,6 +4936,38 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardAttachments(cardId);
       return result;
     }
+    case "harmony_upload_card_attachment": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const filePath = args.filePath != null ? z.string().parse(args.filePath) : undefined;
+      const base64Data = args.base64Data != null ? z.string().parse(args.base64Data) : undefined;
+      let fileName = args.fileName != null ? z.string().parse(args.fileName) : undefined;
+      const contentType = args.contentType != null ? z.string().parse(args.contentType) : undefined;
+      if (filePath && base64Data) {
+        throw new Error("Provide either filePath or base64Data, not both.");
+      }
+      let data;
+      if (filePath) {
+        const bytes = await readFile(filePath);
+        if (bytes.byteLength === 0) {
+          throw new Error(`File is empty: ${filePath}`);
+        }
+        data = bytes.toString("base64");
+        fileName = fileName || basename(filePath);
+      } else if (base64Data) {
+        if (!fileName) {
+          throw new Error("fileName is required when using base64Data.");
+        }
+        data = base64Data;
+      } else {
+        throw new Error("Provide either filePath or base64Data.");
+      }
+      const result = await client3.uploadCardAttachment(cardId, {
+        fileName,
+        data,
+        fileType: contentType
+      });
+      return result;
+    }
     case "harmony_get_card_external_links": {
       const cardId = z.string().uuid().parse(args.cardId);
       const result = await client3.getCardExternalLinks(cardId);

package/dist/index.js

@@ -506,6 +506,10 @@ var init_prompt_builder = __esm(() => {
     execute: `EXECUTE MODE: Implement this task completely. Write production-ready code following best practices. Include necessary tests and documentation.`
   };
 });
+
+// src/server.ts
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
 // ../memory/dist/sync.js
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
@@ -1519,6 +1523,9 @@ class HarmonyApiClient {
   async getCardAttachments(cardId) {
     return this.request("GET", `/cards/${cardId}/attachments`);
   }
+  async uploadCardAttachment(cardId, data) {
+    return this.request("POST", `/cards/${cardId}/attachments`, data);
+  }
   async getCardExternalLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }
@@ -3481,6 +3488,32 @@ var TOOLS = {
       required: ["cardId"]
     }
   },
+  harmony_upload_card_attachment: {
+    description: "Upload a file attachment to a card (e.g. a pasted screenshot or a document). Provide the file either as `filePath` (a local path the MCP server can read — works in local/stdio mode) or as `base64Data` (raw base64 bytes — works everywhere, including remote mode). Max 5MB. Allowed: PNG, JPEG, GIF, WebP, HEIC/HEIF, PDF, DOC/DOCX, XLS/XLSX, TXT. Returns the stored attachment with a short-lived signed URL.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID" },
+        filePath: {
+          type: "string",
+          description: "Absolute path to a local file the MCP server process can read. Mutually exclusive with base64Data."
+        },
+        base64Data: {
+          type: "string",
+          description: "Base64-encoded file bytes (a `data:` URL prefix is accepted and stripped). Requires fileName. Mutually exclusive with filePath."
+        },
+        fileName: {
+          type: "string",
+          description: "File name including extension (e.g. 'screenshot.png'). Required with base64Data; defaults to the basename of filePath otherwise."
+        },
+        contentType: {
+          type: "string",
+          description: "Optional MIME type (e.g. 'image/png'). Inferred from the file extension when omitted."
+        }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_get_card_external_links: {
     description: "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
     inputSchema: {
@@ -4899,6 +4932,38 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.getCardAttachments(cardId);
       return result;
     }
+    case "harmony_upload_card_attachment": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const filePath = args.filePath != null ? z.string().parse(args.filePath) : undefined;
+      const base64Data = args.base64Data != null ? z.string().parse(args.base64Data) : undefined;
+      let fileName = args.fileName != null ? z.string().parse(args.fileName) : undefined;
+      const contentType = args.contentType != null ? z.string().parse(args.contentType) : undefined;
+      if (filePath && base64Data) {
+        throw new Error("Provide either filePath or base64Data, not both.");
+      }
+      let data;
+      if (filePath) {
+        const bytes = await readFile(filePath);
+        if (bytes.byteLength === 0) {
+          throw new Error(`File is empty: ${filePath}`);
+        }
+        data = bytes.toString("base64");
+        fileName = fileName || basename(filePath);
+      } else if (base64Data) {
+        if (!fileName) {
+          throw new Error("fileName is required when using base64Data.");
+        }
+        data = base64Data;
+      } else {
+        throw new Error("Provide either filePath or base64Data.");
+      }
+      const result = await client3.uploadCardAttachment(cardId, {
+        fileName,
+        data,
+        fileType: contentType
+      });
+      return result;
+    }
     case "harmony_get_card_external_links": {
       const cardId = z.string().uuid().parse(args.cardId);
       const result = await client3.getCardExternalLinks(cardId);

package/dist/lib/api-client.js

@@ -1126,6 +1126,9 @@ class HarmonyApiClient {
   async getCardAttachments(cardId) {
     return this.request("GET", `/cards/${cardId}/attachments`);
   }
+  async uploadCardAttachment(cardId, data) {
+    return this.request("POST", `/cards/${cardId}/attachments`, data);
+  }
   async getCardExternalLinks(cardId) {
     return this.request("GET", `/cards/${cardId}/external-links`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gethmy/mcp",
-  "version": "2.9.2",
+  "version": "2.9.4",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "publishConfig": {
     "access": "public"

package/src/api-client.ts

@@ -583,6 +583,13 @@ export class HarmonyApiClient {
     return this.request("GET", `/cards/${cardId}/attachments`);
   }
 
+  async uploadCardAttachment(
+    cardId: string,
+    data: { fileName: string; data: string; fileType?: string },
+  ): Promise<{ attachment: CardAttachment }> {
+    return this.request("POST", `/cards/${cardId}/attachments`, data);
+  }
+
   async getCardExternalLinks(
     cardId: string,
   ): Promise<{ external_links: CardExternalLinkRow[] }> {
@@ -728,6 +735,7 @@ export class HarmonyApiClient {
       cacheCreationInputTokens?: number;
       cacheReadInputTokens?: number;
       modelName?: string;
+      numTurns?: number;
       recentActions?: { action: string; ts: string }[];
       failureReason?:
         | "verification"
@@ -761,6 +769,7 @@ export class HarmonyApiClient {
       cacheCreationInputTokens?: number;
       cacheReadInputTokens?: number;
       modelName?: string;
+      numTurns?: number;
       failureReason?:
         | "verification"
         | "review"

package/src/server.ts

@@ -1,3 +1,5 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
 import { syncFull, syncPull, syncPush } from "@harmony/memory";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -616,6 +618,37 @@ export const TOOLS = {
       required: ["cardId"],
     },
   },
+  harmony_upload_card_attachment: {
+    description:
+      "Upload a file attachment to a card (e.g. a pasted screenshot or a document). Provide the file either as `filePath` (a local path the MCP server can read — works in local/stdio mode) or as `base64Data` (raw base64 bytes — works everywhere, including remote mode). Max 5MB. Allowed: PNG, JPEG, GIF, WebP, HEIC/HEIF, PDF, DOC/DOCX, XLS/XLSX, TXT. Returns the stored attachment with a short-lived signed URL.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID" },
+        filePath: {
+          type: "string",
+          description:
+            "Absolute path to a local file the MCP server process can read. Mutually exclusive with base64Data.",
+        },
+        base64Data: {
+          type: "string",
+          description:
+            "Base64-encoded file bytes (a `data:` URL prefix is accepted and stripped). Requires fileName. Mutually exclusive with filePath.",
+        },
+        fileName: {
+          type: "string",
+          description:
+            "File name including extension (e.g. 'screenshot.png'). Required with base64Data; defaults to the basename of filePath otherwise.",
+        },
+        contentType: {
+          type: "string",
+          description:
+            "Optional MIME type (e.g. 'image/png'). Inferred from the file extension when omitted.",
+        },
+      },
+      required: ["cardId"],
+    },
+  },
   harmony_get_card_external_links: {
     description:
       "Get external URL references attached to a card (links to docs, gists, dashboards, etc.).",
@@ -2344,6 +2377,48 @@ async function handleToolCall(
       return result;
     }
 
+    case "harmony_upload_card_attachment": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const filePath =
+        args.filePath != null ? z.string().parse(args.filePath) : undefined;
+      const base64Data =
+        args.base64Data != null ? z.string().parse(args.base64Data) : undefined;
+      let fileName =
+        args.fileName != null ? z.string().parse(args.fileName) : undefined;
+      const contentType =
+        args.contentType != null
+          ? z.string().parse(args.contentType)
+          : undefined;
+
+      if (filePath && base64Data) {
+        throw new Error("Provide either filePath or base64Data, not both.");
+      }
+
+      let data: string;
+      if (filePath) {
+        const bytes = await readFile(filePath);
+        if (bytes.byteLength === 0) {
+          throw new Error(`File is empty: ${filePath}`);
+        }
+        data = bytes.toString("base64");
+        fileName = fileName || basename(filePath);
+      } else if (base64Data) {
+        if (!fileName) {
+          throw new Error("fileName is required when using base64Data.");
+        }
+        data = base64Data;
+      } else {
+        throw new Error("Provide either filePath or base64Data.");
+      }
+
+      const result = await client.uploadCardAttachment(cardId, {
+        fileName: fileName as string,
+        data,
+        fileType: contentType,
+      });
+      return result;
+    }
+
     case "harmony_get_card_external_links": {
       const cardId = z.string().uuid().parse(args.cardId);
       const result = await client.getCardExternalLinks(cardId);