harmony-mcp 1.0.3 → 1.0.4

package/dist/cli.js

@@ -24960,8 +24960,18 @@ class HarmonyApiClient {
   async listProjects(workspaceId) {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
-  async getBoard(projectId) {
-    return this.request("GET", `/board/${projectId}`);
+  async getBoard(projectId, options) {
+    const params = new URLSearchParams;
+    if (options?.limit !== undefined)
+      params.set("limit", String(options.limit));
+    if (options?.offset !== undefined)
+      params.set("offset", String(options.offset));
+    if (options?.columnId)
+      params.set("column_id", options.columnId);
+    if (options?.summary)
+      params.set("summary", "true");
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.request("GET", `/board/${projectId}${query}`);
   }
   async createCard(projectId, data) {
     return this.request("POST", "/cards", { projectId, ...data });
@@ -24978,6 +24988,9 @@ class HarmonyApiClient {
   async getCard(cardId) {
     return this.request("GET", `/cards/${cardId}`);
   }
+  async getCardByShortId(projectId, shortId) {
+    return this.request("GET", `/projects/${projectId}/cards/${shortId}`);
+  }
   async searchCards(query, options) {
     const params = new URLSearchParams({ q: query });
     if (options?.projectId) {
@@ -25101,15 +25114,26 @@ var TOOLS = {
     }
   },
   harmony_get_card: {
-    description: "Get detailed information about a specific card",
+    description: "Get detailed information about a specific card by UUID",
     inputSchema: {
       type: "object",
       properties: {
-        cardId: { type: "string", description: "Card ID" }
+        cardId: { type: "string", description: "Card UUID" }
       },
       required: ["cardId"]
     }
   },
+  harmony_get_card_by_short_id: {
+    description: "Get a card by its short ID (e.g., #42) within a project",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID (optional if context set)" },
+        shortId: { type: "number", description: "Short ID number (e.g., 42 for card #42)" }
+      },
+      required: ["shortId"]
+    }
+  },
   harmony_create_column: {
     description: "Create a new column in a project",
     inputSchema: {
@@ -25224,11 +25248,15 @@ var TOOLS = {
     }
   },
   harmony_get_board: {
-    description: "Get the full board state (columns, cards, labels) for a project",
+    description: "Get board state (columns, cards, labels). Use limit/offset for pagination on large boards. Use summary=true for just column counts without card details.",
     inputSchema: {
       type: "object",
       properties: {
-        projectId: { type: "string", description: "Project ID (optional if context set)" }
+        projectId: { type: "string", description: "Project ID (optional if context set)" },
+        limit: { type: "number", description: "Max cards to return (default: 50)" },
+        offset: { type: "number", description: "Skip N cards for pagination (default: 0)" },
+        columnId: { type: "string", description: "Filter cards by column ID" },
+        summary: { type: "boolean", description: "Return only columns with card counts, no card details" }
       }
     }
   },
@@ -25481,6 +25509,12 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
         const result = await client2.getCard(cardId);
         return { success: true, ...result };
       }
+      case "harmony_get_card_by_short_id": {
+        const shortId = exports_external.number().int().positive().parse(args.shortId);
+        const projectId = args.projectId || getProjectId();
+        const result = await client2.getCardByShortId(projectId, shortId);
+        return { success: true, ...result };
+      }
       case "harmony_create_column": {
         const name2 = exports_external.string().min(1).parse(args.name);
         const projectId = args.projectId || getProjectId();
@@ -25544,7 +25578,16 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
       }
       case "harmony_get_board": {
         const projectId = getProjectId();
-        const result = await client2.getBoard(projectId);
+        const options = {};
+        if (args.limit !== undefined)
+          options.limit = Number(args.limit);
+        if (args.offset !== undefined)
+          options.offset = Number(args.offset);
+        if (args.columnId)
+          options.columnId = String(args.columnId);
+        if (args.summary === true || args.summary === "true")
+          options.summary = true;
+        const result = await client2.getBoard(projectId, options);
         return { success: true, board: result };
       }
       case "harmony_get_workspace_members": {

package/dist/index.js

@@ -23102,8 +23102,18 @@ class HarmonyApiClient {
   async listProjects(workspaceId) {
     return this.request("GET", `/workspaces/${workspaceId}/projects`);
   }
-  async getBoard(projectId) {
-    return this.request("GET", `/board/${projectId}`);
+  async getBoard(projectId, options) {
+    const params = new URLSearchParams;
+    if (options?.limit !== undefined)
+      params.set("limit", String(options.limit));
+    if (options?.offset !== undefined)
+      params.set("offset", String(options.offset));
+    if (options?.columnId)
+      params.set("column_id", options.columnId);
+    if (options?.summary)
+      params.set("summary", "true");
+    const query = params.toString() ? `?${params.toString()}` : "";
+    return this.request("GET", `/board/${projectId}${query}`);
   }
   async createCard(projectId, data) {
     return this.request("POST", "/cards", { projectId, ...data });
@@ -23120,6 +23130,9 @@ class HarmonyApiClient {
   async getCard(cardId) {
     return this.request("GET", `/cards/${cardId}`);
   }
+  async getCardByShortId(projectId, shortId) {
+    return this.request("GET", `/projects/${projectId}/cards/${shortId}`);
+  }
   async searchCards(query, options) {
     const params = new URLSearchParams({ q: query });
     if (options?.projectId) {
@@ -23243,15 +23256,26 @@ var TOOLS = {
     }
   },
   harmony_get_card: {
-    description: "Get detailed information about a specific card",
+    description: "Get detailed information about a specific card by UUID",
     inputSchema: {
       type: "object",
       properties: {
-        cardId: { type: "string", description: "Card ID" }
+        cardId: { type: "string", description: "Card UUID" }
       },
       required: ["cardId"]
     }
   },
+  harmony_get_card_by_short_id: {
+    description: "Get a card by its short ID (e.g., #42) within a project",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectId: { type: "string", description: "Project ID (optional if context set)" },
+        shortId: { type: "number", description: "Short ID number (e.g., 42 for card #42)" }
+      },
+      required: ["shortId"]
+    }
+  },
   harmony_create_column: {
     description: "Create a new column in a project",
     inputSchema: {
@@ -23366,11 +23390,15 @@ var TOOLS = {
     }
   },
   harmony_get_board: {
-    description: "Get the full board state (columns, cards, labels) for a project",
+    description: "Get board state (columns, cards, labels). Use limit/offset for pagination on large boards. Use summary=true for just column counts without card details.",
     inputSchema: {
       type: "object",
       properties: {
-        projectId: { type: "string", description: "Project ID (optional if context set)" }
+        projectId: { type: "string", description: "Project ID (optional if context set)" },
+        limit: { type: "number", description: "Max cards to return (default: 50)" },
+        offset: { type: "number", description: "Skip N cards for pagination (default: 0)" },
+        columnId: { type: "string", description: "Filter cards by column ID" },
+        summary: { type: "boolean", description: "Return only columns with card counts, no card details" }
       }
     }
   },
@@ -23623,6 +23651,12 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
         const result = await client2.getCard(cardId);
         return { success: true, ...result };
       }
+      case "harmony_get_card_by_short_id": {
+        const shortId = exports_external.number().int().positive().parse(args.shortId);
+        const projectId = args.projectId || getProjectId();
+        const result = await client2.getCardByShortId(projectId, shortId);
+        return { success: true, ...result };
+      }
       case "harmony_create_column": {
         const name2 = exports_external.string().min(1).parse(args.name);
         const projectId = args.projectId || getProjectId();
@@ -23686,7 +23720,16 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
       }
       case "harmony_get_board": {
         const projectId = getProjectId();
-        const result = await client2.getBoard(projectId);
+        const options = {};
+        if (args.limit !== undefined)
+          options.limit = Number(args.limit);
+        if (args.offset !== undefined)
+          options.offset = Number(args.offset);
+        if (args.columnId)
+          options.columnId = String(args.columnId);
+        if (args.summary === true || args.summary === "true")
+          options.summary = true;
+        const result = await client2.getBoard(projectId, options);
         return { success: true, board: result };
       }
       case "harmony_get_workspace_members": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harmony-mcp",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "MCP server for Harmony Kanban board - enables Claude Code to manage your boards",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/nicholasgriffintn/harmony"
+    "url": "git+https://github.com/nicholasgriffintn/harmony.git"
   },
   "homepage": "https://gethmy.com",
   "bugs": {