@gethmy/mcp 2.8.3 → 2.8.4

package/dist/cli.js

@@ -1551,6 +1551,9 @@ class HarmonyApiClient {
   async toggleSubtask(subtaskId) {
     return this.request("POST", `/subtasks/${subtaskId}/toggle`);
   }
+  async updateSubtask(subtaskId, updates) {
+    return this.request("PATCH", `/subtasks/${subtaskId}`, updates);
+  }
   async deleteSubtask(subtaskId) {
     return this.request("DELETE", `/subtasks/${subtaskId}`);
   }
@@ -2026,7 +2029,8 @@ var AUTO_START_TRIGGERS = new Set([
   "harmony_generate_prompt",
   "harmony_update_card",
   "harmony_create_subtask",
-  "harmony_toggle_subtask"
+  "harmony_toggle_subtask",
+  "harmony_update_subtask"
 ]);
 var INACTIVITY_TIMEOUT_MS = 10 * 60 * 1000;
 var CHECK_INTERVAL_MS = 60 * 1000;
@@ -2944,7 +2948,12 @@ var TOOLS = {
         priority: { type: "string", enum: ["low", "medium", "high", "urgent"] },
         assigneeId: { type: "string", nullable: true },
         dueDate: { type: "string", nullable: true },
-        done: { type: "boolean", description: "Mark card as done or not done" }
+        done: { type: "boolean", description: "Mark card as done or not done" },
+        planId: {
+          type: "string",
+          nullable: true,
+          description: "Plan ID to link this card to, or null to unlink. Sets cards.plan_id. The plan must exist and belong to the same project."
+        }
       },
       required: ["cardId"]
     }
@@ -3243,6 +3252,25 @@ var TOOLS = {
       required: ["subtaskId"]
     }
   },
+  harmony_update_subtask: {
+    description: "Update a subtask: rename its title, set an explicit completion state, and/or reorder it. Unlike harmony_toggle_subtask (which flips completion), `completed` here sets an explicit value — safe to call idempotently. At least one of title/completed/position is required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        subtaskId: { type: "string" },
+        title: { type: "string", description: "New title (1–500 chars)" },
+        completed: {
+          type: "boolean",
+          description: "Explicit completion state (set, not toggle)"
+        },
+        position: {
+          type: "number",
+          description: "New position (0-based ordering within the card)"
+        }
+      },
+      required: ["subtaskId"]
+    }
+  },
   harmony_delete_subtask: {
     description: "Delete a subtask",
     inputSchema: {
@@ -4360,13 +4388,15 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_update_card": {
       const cardId = z.string().uuid().parse(args.cardId);
+      const planId = args.planId === undefined ? undefined : args.planId === null ? null : z.string().uuid().parse(args.planId);
       const result = await client3.updateCard(cardId, {
         title: args.title,
         description: args.description,
         priority: args.priority,
         assigneeId: args.assigneeId,
         dueDate: args.dueDate,
-        done: args.done
+        done: args.done,
+        planId
       });
       return { success: true, ...result };
     }
@@ -4569,6 +4599,24 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.toggleSubtask(subtaskId);
       return { success: true, ...result };
     }
+    case "harmony_update_subtask": {
+      const subtaskId = z.string().uuid().parse(args.subtaskId);
+      const updates = {};
+      if (args.title !== undefined) {
+        updates.title = z.string().min(1).max(500).parse(args.title);
+      }
+      if (args.completed !== undefined) {
+        updates.completed = z.boolean().parse(args.completed);
+      }
+      if (args.position !== undefined) {
+        updates.position = z.number().int().min(0).parse(args.position);
+      }
+      if (Object.keys(updates).length === 0) {
+        throw new Error("harmony_update_subtask requires at least one of: title, completed, position");
+      }
+      const result = await client3.updateSubtask(subtaskId, updates);
+      return { success: true, ...result };
+    }
     case "harmony_delete_subtask": {
       const subtaskId = z.string().uuid().parse(args.subtaskId);
       await client3.deleteSubtask(subtaskId);

package/dist/index.js

@@ -1547,6 +1547,9 @@ class HarmonyApiClient {
   async toggleSubtask(subtaskId) {
     return this.request("POST", `/subtasks/${subtaskId}/toggle`);
   }
+  async updateSubtask(subtaskId, updates) {
+    return this.request("PATCH", `/subtasks/${subtaskId}`, updates);
+  }
   async deleteSubtask(subtaskId) {
     return this.request("DELETE", `/subtasks/${subtaskId}`);
   }
@@ -2022,7 +2025,8 @@ var AUTO_START_TRIGGERS = new Set([
   "harmony_generate_prompt",
   "harmony_update_card",
   "harmony_create_subtask",
-  "harmony_toggle_subtask"
+  "harmony_toggle_subtask",
+  "harmony_update_subtask"
 ]);
 var INACTIVITY_TIMEOUT_MS = 10 * 60 * 1000;
 var CHECK_INTERVAL_MS = 60 * 1000;
@@ -2940,7 +2944,12 @@ var TOOLS = {
         priority: { type: "string", enum: ["low", "medium", "high", "urgent"] },
         assigneeId: { type: "string", nullable: true },
         dueDate: { type: "string", nullable: true },
-        done: { type: "boolean", description: "Mark card as done or not done" }
+        done: { type: "boolean", description: "Mark card as done or not done" },
+        planId: {
+          type: "string",
+          nullable: true,
+          description: "Plan ID to link this card to, or null to unlink. Sets cards.plan_id. The plan must exist and belong to the same project."
+        }
       },
       required: ["cardId"]
     }
@@ -3239,6 +3248,25 @@ var TOOLS = {
       required: ["subtaskId"]
     }
   },
+  harmony_update_subtask: {
+    description: "Update a subtask: rename its title, set an explicit completion state, and/or reorder it. Unlike harmony_toggle_subtask (which flips completion), `completed` here sets an explicit value — safe to call idempotently. At least one of title/completed/position is required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        subtaskId: { type: "string" },
+        title: { type: "string", description: "New title (1–500 chars)" },
+        completed: {
+          type: "boolean",
+          description: "Explicit completion state (set, not toggle)"
+        },
+        position: {
+          type: "number",
+          description: "New position (0-based ordering within the card)"
+        }
+      },
+      required: ["subtaskId"]
+    }
+  },
   harmony_delete_subtask: {
     description: "Delete a subtask",
     inputSchema: {
@@ -4356,13 +4384,15 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_update_card": {
       const cardId = z.string().uuid().parse(args.cardId);
+      const planId = args.planId === undefined ? undefined : args.planId === null ? null : z.string().uuid().parse(args.planId);
       const result = await client3.updateCard(cardId, {
         title: args.title,
         description: args.description,
         priority: args.priority,
         assigneeId: args.assigneeId,
         dueDate: args.dueDate,
-        done: args.done
+        done: args.done,
+        planId
       });
       return { success: true, ...result };
     }
@@ -4565,6 +4595,24 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.toggleSubtask(subtaskId);
       return { success: true, ...result };
     }
+    case "harmony_update_subtask": {
+      const subtaskId = z.string().uuid().parse(args.subtaskId);
+      const updates = {};
+      if (args.title !== undefined) {
+        updates.title = z.string().min(1).max(500).parse(args.title);
+      }
+      if (args.completed !== undefined) {
+        updates.completed = z.boolean().parse(args.completed);
+      }
+      if (args.position !== undefined) {
+        updates.position = z.number().int().min(0).parse(args.position);
+      }
+      if (Object.keys(updates).length === 0) {
+        throw new Error("harmony_update_subtask requires at least one of: title, completed, position");
+      }
+      const result = await client3.updateSubtask(subtaskId, updates);
+      return { success: true, ...result };
+    }
     case "harmony_delete_subtask": {
       const subtaskId = z.string().uuid().parse(args.subtaskId);
       await client3.deleteSubtask(subtaskId);

package/dist/lib/api-client.js

@@ -1154,6 +1154,9 @@ class HarmonyApiClient {
   async toggleSubtask(subtaskId) {
     return this.request("POST", `/subtasks/${subtaskId}/toggle`);
   }
+  async updateSubtask(subtaskId, updates) {
+    return this.request("PATCH", `/subtasks/${subtaskId}`, updates);
+  }
   async deleteSubtask(subtaskId) {
     return this.request("DELETE", `/subtasks/${subtaskId}`);
   }

package/package.json

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

package/src/api-client.ts

@@ -474,6 +474,7 @@ export class HarmonyApiClient {
       dueDate?: string | null;
       done?: boolean;
       archivedAt?: string | null;
+      planId?: string | null;
     },
   ): Promise<{ card: unknown }> {
     return this.request("PATCH", `/cards/${cardId}`, updates);
@@ -617,6 +618,13 @@ export class HarmonyApiClient {
     return this.request("POST", `/subtasks/${subtaskId}/toggle`);
   }
 
+  async updateSubtask(
+    subtaskId: string,
+    updates: { title?: string; completed?: boolean; position?: number },
+  ): Promise<{ subtask: unknown }> {
+    return this.request("PATCH", `/subtasks/${subtaskId}`, updates);
+  }
+
   async deleteSubtask(subtaskId: string): Promise<{ success: boolean }> {
     return this.request("DELETE", `/subtasks/${subtaskId}`);
   }

package/src/auto-session.ts

@@ -78,6 +78,7 @@ export const AUTO_START_TRIGGERS = new Set([
   "harmony_update_card",
   "harmony_create_subtask",
   "harmony_toggle_subtask",
+  "harmony_update_subtask",
 ]);
 
 export const INACTIVITY_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes

package/src/server.ts

@@ -308,6 +308,12 @@ export const TOOLS = {
         assigneeId: { type: "string", nullable: true },
         dueDate: { type: "string", nullable: true },
         done: { type: "boolean", description: "Mark card as done or not done" },
+        planId: {
+          type: "string",
+          nullable: true,
+          description:
+            "Plan ID to link this card to, or null to unlink. Sets cards.plan_id. The plan must exist and belong to the same project.",
+        },
       },
       required: ["cardId"],
     },
@@ -625,6 +631,26 @@ export const TOOLS = {
       required: ["subtaskId"],
     },
   },
+  harmony_update_subtask: {
+    description:
+      "Update a subtask: rename its title, set an explicit completion state, and/or reorder it. Unlike harmony_toggle_subtask (which flips completion), `completed` here sets an explicit value — safe to call idempotently. At least one of title/completed/position is required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        subtaskId: { type: "string" },
+        title: { type: "string", description: "New title (1–500 chars)" },
+        completed: {
+          type: "boolean",
+          description: "Explicit completion state (set, not toggle)",
+        },
+        position: {
+          type: "number",
+          description: "New position (0-based ordering within the card)",
+        },
+      },
+      required: ["subtaskId"],
+    },
+  },
   harmony_delete_subtask: {
     description: "Delete a subtask",
     inputSchema: {
@@ -1944,6 +1970,13 @@ async function handleToolCall(
 
     case "harmony_update_card": {
       const cardId = z.string().uuid().parse(args.cardId);
+      // null = unlink, undefined = leave untouched, otherwise must be a UUID.
+      const planId =
+        args.planId === undefined
+          ? undefined
+          : args.planId === null
+            ? null
+            : z.string().uuid().parse(args.planId);
       const result = await client.updateCard(cardId, {
         title: args.title as string | undefined,
         description: args.description as string | undefined,
@@ -1951,6 +1984,7 @@ async function handleToolCall(
         assigneeId: args.assigneeId as string | null | undefined,
         dueDate: args.dueDate as string | null | undefined,
         done: args.done as boolean | undefined,
+        planId,
       });
       return { success: true, ...result };
     }
@@ -2237,6 +2271,31 @@ async function handleToolCall(
       return { success: true, ...result };
     }
 
+    case "harmony_update_subtask": {
+      const subtaskId = z.string().uuid().parse(args.subtaskId);
+      const updates: {
+        title?: string;
+        completed?: boolean;
+        position?: number;
+      } = {};
+      if (args.title !== undefined) {
+        updates.title = z.string().min(1).max(500).parse(args.title);
+      }
+      if (args.completed !== undefined) {
+        updates.completed = z.boolean().parse(args.completed);
+      }
+      if (args.position !== undefined) {
+        updates.position = z.number().int().min(0).parse(args.position);
+      }
+      if (Object.keys(updates).length === 0) {
+        throw new Error(
+          "harmony_update_subtask requires at least one of: title, completed, position",
+        );
+      }
+      const result = await client.updateSubtask(subtaskId, updates);
+      return { success: true, ...result };
+    }
+
     case "harmony_delete_subtask": {
       const subtaskId = z.string().uuid().parse(args.subtaskId);
       await client.deleteSubtask(subtaskId);