@gethmy/mcp 2.4.2 → 2.4.4

package/README.md

@@ -5,7 +5,7 @@ Enables AI coding agents (Claude Code, OpenAI Codex, Cursor) to interact with yo
 
 ## Features
 
-- **61+ MCP Tools** for full board control, knowledge graph, and workflow plans
+- **67 MCP Tools** for full board control, knowledge graph, and workflow plans
 - **Knowledge Graph Memory** - persistent memory with entity types, tiers, scopes, and typed relations
 - **Active Learning** - auto-extracts lessons, solutions, and error patterns from completed work sessions
 - **Context Assembly** - token-budget-aware memory injection into AI prompts
@@ -95,7 +95,7 @@ If you prefer to configure manually (e.g., in Claude.ai's UI):
 1. Get an API key from [Harmony](https://gethmy.com/user/keys)
 2. In Claude.ai, add a remote MCP server with URL `https://mcp.gethmy.com/mcp`
 3. Set the Authorization header to `Bearer hmy_your_key_here`
-4. All 61+ Harmony tools become available in your conversation
+4. All 67 Harmony tools become available in your conversation
 
 **Session management** is automatic - sessions have a 1-hour TTL and are created/renewed transparently.
 
@@ -324,6 +324,9 @@ Store and retrieve persistent knowledge across sessions. Memories have types, ti
 - `harmony_consolidate_memories` - Cluster similar draft/episode memories and merge into reference entities (dry-run by default)
 - `harmony_backfill_embeddings` - Generate vector embeddings for entities missing them
 - `harmony_backfill_relations` - Retroactively create semantic relations across existing entities
+- `harmony_cleanup_memories` - Bulk cleanup helper: flag stale drafts, dedupe boilerplate, trim low-value entries
+- `harmony_audit_memories` - Surface low-confidence or low-quality memories for human review
+- `harmony_purge_memories` - Hard-delete archived or flagged memories (dry-run by default)
 
 ### Context Debugging
 

package/dist/cli.js

@@ -27094,9 +27094,20 @@ class HarmonyApiClient {
           },
           body: options?.rawBody ?? (body ? JSON.stringify(body) : undefined)
         });
-        const data = await response.json();
+        const text = await response.text();
+        const responseContentType = response.headers.get("content-type") || "";
+        const looksLikeJson = responseContentType.includes("application/json");
+        let data = null;
+        let parseError = null;
+        if (text) {
+          try {
+            data = JSON.parse(text);
+          } catch (err) {
+            parseError = err instanceof Error ? err : new Error(String(err));
+          }
+        }
         if (!response.ok) {
-          const errorMsg = data.error || `API error: ${response.status}`;
+          const errorMsg = data?.error || (looksLikeJson ? null : `API error: ${response.status} (non-JSON response)`) || `API error: ${response.status}`;
           if (!isRetryableError(null, response.status)) {
             throw new Error(errorMsg);
           }
@@ -27107,6 +27118,9 @@ class HarmonyApiClient {
           }
           throw lastError;
         }
+        if (parseError) {
+          throw new Error(`API returned ${response.status} with invalid JSON body: ${parseError.message}`);
+        }
         return data;
       } catch (error48) {
         lastError = error48 instanceof Error ? error48 : new Error(String(error48));
@@ -27255,6 +27269,9 @@ class HarmonyApiClient {
   async createLabel(projectId, data) {
     return this.request("POST", "/labels", { projectId, ...data });
   }
+  async deleteLabel(labelId) {
+    return this.request("DELETE", `/labels/${labelId}`);
+  }
   async createSubtask(cardId, title) {
     return this.request("POST", "/subtasks", { cardId, title });
   }
@@ -28170,7 +28187,10 @@ function scoreEntity(entity, relationCount, archiveBelow, deleteBelow, staleDraf
     legacyReasons.push("no graph presence");
   }
   let bucket;
-  if (score < deleteBelow)
+  if (boilerplate && deleteBelow > 0) {
+    bucket = "delete";
+    reasons.push("boilerplate override");
+  } else if (score < deleteBelow)
     bucket = "delete";
   else if (score < archiveBelow)
     bucket = "archive";
@@ -28994,6 +29014,30 @@ async function onboardNewUser(params) {
 
 // src/server.ts
 var memorySessions = new Map;
+function parseLabelList(raw) {
+  if (raw === undefined || raw === null)
+    return;
+  if (Array.isArray(raw)) {
+    const arr = raw.filter((v) => typeof v === "string").map((v) => v.trim()).filter((v) => v.length > 0);
+    return arr.length ? arr : undefined;
+  }
+  if (typeof raw === "string") {
+    const trimmed = raw.trim();
+    if (!trimmed)
+      return;
+    if (trimmed.startsWith("[")) {
+      try {
+        const parsed = JSON.parse(trimmed);
+        if (Array.isArray(parsed) && parsed.every((x) => typeof x === "string")) {
+          const arr = parsed.map((v) => v.trim()).filter((v) => v.length > 0);
+          return arr.length ? arr : undefined;
+        }
+      } catch {}
+    }
+    return [trimmed];
+  }
+  return;
+}
 function initMemorySession(cardId, agentIdentifier, agentName) {
   memorySessions.set(cardId, {
     cardId,
@@ -29271,6 +29315,16 @@ var TOOLS = {
       required: ["name", "color"]
     }
   },
+  harmony_delete_label: {
+    description: "Delete a label from a project. Also removes it from any cards that reference it.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        labelId: { type: "string", description: "Label ID to delete" }
+      },
+      required: ["labelId"]
+    }
+  },
   harmony_add_label_to_card: {
     description: "Add a label to a card. Provide labelId directly, or labelName to look up (or auto-create) the label by name.",
     inputSchema: {
@@ -30924,6 +30978,11 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.createLabel(projectId, { name: name2, color });
       return { success: true, ...result };
     }
+    case "harmony_delete_label": {
+      const labelId = exports_external.string().uuid().parse(args.labelId);
+      const result = await client3.deleteLabel(labelId);
+      return { success: true, ...result };
+    }
     case "harmony_add_label_to_card": {
       const cardId = exports_external.string().uuid().parse(args.cardId);
       let labelId = args.labelId ? exports_external.string().uuid().parse(args.labelId) : undefined;
@@ -31059,7 +31118,7 @@ async function handleToolCall(name, args, deps) {
       const agentIdentifier = exports_external.string().min(1).max(100).parse(args.agentIdentifier);
       const agentName = exports_external.string().min(1).max(100).parse(args.agentName);
       const moveToColumn = args.moveToColumn;
-      const addLabels = args.addLabels;
+      const addLabels = parseLabelList(args.addLabels);
       let movedTo = null;
       const labelsAdded = [];
       if (moveToColumn || addLabels?.length) {

package/dist/index.js

@@ -24854,9 +24854,20 @@ class HarmonyApiClient {
           },
           body: options?.rawBody ?? (body ? JSON.stringify(body) : undefined)
         });
-        const data = await response.json();
+        const text = await response.text();
+        const responseContentType = response.headers.get("content-type") || "";
+        const looksLikeJson = responseContentType.includes("application/json");
+        let data = null;
+        let parseError = null;
+        if (text) {
+          try {
+            data = JSON.parse(text);
+          } catch (err) {
+            parseError = err instanceof Error ? err : new Error(String(err));
+          }
+        }
         if (!response.ok) {
-          const errorMsg = data.error || `API error: ${response.status}`;
+          const errorMsg = data?.error || (looksLikeJson ? null : `API error: ${response.status} (non-JSON response)`) || `API error: ${response.status}`;
           if (!isRetryableError(null, response.status)) {
             throw new Error(errorMsg);
           }
@@ -24867,6 +24878,9 @@ class HarmonyApiClient {
           }
           throw lastError;
         }
+        if (parseError) {
+          throw new Error(`API returned ${response.status} with invalid JSON body: ${parseError.message}`);
+        }
         return data;
       } catch (error48) {
         lastError = error48 instanceof Error ? error48 : new Error(String(error48));
@@ -25015,6 +25029,9 @@ class HarmonyApiClient {
   async createLabel(projectId, data) {
     return this.request("POST", "/labels", { projectId, ...data });
   }
+  async deleteLabel(labelId) {
+    return this.request("DELETE", `/labels/${labelId}`);
+  }
   async createSubtask(cardId, title) {
     return this.request("POST", "/subtasks", { cardId, title });
   }
@@ -25930,7 +25947,10 @@ function scoreEntity(entity, relationCount, archiveBelow, deleteBelow, staleDraf
     legacyReasons.push("no graph presence");
   }
   let bucket;
-  if (score < deleteBelow)
+  if (boilerplate && deleteBelow > 0) {
+    bucket = "delete";
+    reasons.push("boilerplate override");
+  } else if (score < deleteBelow)
     bucket = "delete";
   else if (score < archiveBelow)
     bucket = "archive";
@@ -26754,6 +26774,30 @@ async function onboardNewUser(params) {
 
 // src/server.ts
 var memorySessions = new Map;
+function parseLabelList(raw) {
+  if (raw === undefined || raw === null)
+    return;
+  if (Array.isArray(raw)) {
+    const arr = raw.filter((v) => typeof v === "string").map((v) => v.trim()).filter((v) => v.length > 0);
+    return arr.length ? arr : undefined;
+  }
+  if (typeof raw === "string") {
+    const trimmed = raw.trim();
+    if (!trimmed)
+      return;
+    if (trimmed.startsWith("[")) {
+      try {
+        const parsed = JSON.parse(trimmed);
+        if (Array.isArray(parsed) && parsed.every((x) => typeof x === "string")) {
+          const arr = parsed.map((v) => v.trim()).filter((v) => v.length > 0);
+          return arr.length ? arr : undefined;
+        }
+      } catch {}
+    }
+    return [trimmed];
+  }
+  return;
+}
 function initMemorySession(cardId, agentIdentifier, agentName) {
   memorySessions.set(cardId, {
     cardId,
@@ -27031,6 +27075,16 @@ var TOOLS = {
       required: ["name", "color"]
     }
   },
+  harmony_delete_label: {
+    description: "Delete a label from a project. Also removes it from any cards that reference it.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        labelId: { type: "string", description: "Label ID to delete" }
+      },
+      required: ["labelId"]
+    }
+  },
   harmony_add_label_to_card: {
     description: "Add a label to a card. Provide labelId directly, or labelName to look up (or auto-create) the label by name.",
     inputSchema: {
@@ -28684,6 +28738,11 @@ async function handleToolCall(name, args, deps) {
       const result = await client3.createLabel(projectId, { name: name2, color });
       return { success: true, ...result };
     }
+    case "harmony_delete_label": {
+      const labelId = exports_external.string().uuid().parse(args.labelId);
+      const result = await client3.deleteLabel(labelId);
+      return { success: true, ...result };
+    }
     case "harmony_add_label_to_card": {
       const cardId = exports_external.string().uuid().parse(args.cardId);
       let labelId = args.labelId ? exports_external.string().uuid().parse(args.labelId) : undefined;
@@ -28819,7 +28878,7 @@ async function handleToolCall(name, args, deps) {
       const agentIdentifier = exports_external.string().min(1).max(100).parse(args.agentIdentifier);
       const agentName = exports_external.string().min(1).max(100).parse(args.agentName);
       const moveToColumn = args.moveToColumn;
-      const addLabels = args.addLabels;
+      const addLabels = parseLabelList(args.addLabels);
       let movedTo = null;
       const labelsAdded = [];
       if (moveToColumn || addLabels?.length) {

package/dist/lib/api-client.js

@@ -1612,9 +1612,20 @@ class HarmonyApiClient {
           },
           body: options?.rawBody ?? (body ? JSON.stringify(body) : undefined)
         });
-        const data = await response.json();
+        const text = await response.text();
+        const responseContentType = response.headers.get("content-type") || "";
+        const looksLikeJson = responseContentType.includes("application/json");
+        let data = null;
+        let parseError = null;
+        if (text) {
+          try {
+            data = JSON.parse(text);
+          } catch (err) {
+            parseError = err instanceof Error ? err : new Error(String(err));
+          }
+        }
         if (!response.ok) {
-          const errorMsg = data.error || `API error: ${response.status}`;
+          const errorMsg = data?.error || (looksLikeJson ? null : `API error: ${response.status} (non-JSON response)`) || `API error: ${response.status}`;
           if (!isRetryableError(null, response.status)) {
             throw new Error(errorMsg);
           }
@@ -1625,6 +1636,9 @@ class HarmonyApiClient {
           }
           throw lastError;
         }
+        if (parseError) {
+          throw new Error(`API returned ${response.status} with invalid JSON body: ${parseError.message}`);
+        }
         return data;
       } catch (error) {
         lastError = error instanceof Error ? error : new Error(String(error));
@@ -1773,6 +1787,9 @@ class HarmonyApiClient {
   async createLabel(projectId, data) {
     return this.request("POST", "/labels", { projectId, ...data });
   }
+  async deleteLabel(labelId) {
+    return this.request("DELETE", `/labels/${labelId}`);
+  }
   async createSubtask(cardId, title) {
     return this.request("POST", "/subtasks", { cardId, title });
   }