harmony-mcp 1.3.1 → 1.3.2

package/README.md

@@ -8,6 +8,7 @@ MCP (Model Context Protocol) server for Harmony Kanban board. Enables AI coding
 - **Card Linking** - create relationships between cards (blocks, relates_to, duplicates, is_part_of)
 - **Prompt Builder** - generate AI-ready prompts from cards with context
 - **Agent Session Tracking** - track work progress with timer badges
+- **Auto-Assignment** - automatically assign cards to you when starting agent sessions
 - **Multi-Agent Support** - works with Claude Code, Codex, Cursor, Windsurf
 - **One-Command Setup** - auto-configure all supported agents
 - **Natural Language Processing** via voice-nlu edge function
@@ -32,6 +33,9 @@ npm install -g harmony-mcp
 
 ```bash
 harmony-mcp configure --api-key hmy_your_key_here
+
+# Optional: Set your email for auto-assignment
+harmony-mcp configure --api-key hmy_your_key_here --user-email you@example.com
 ```
 
 ### 4. Initialize for Your AI Agents
@@ -86,26 +90,30 @@ When you start working on a card (e.g., `/hmy #42`):
 1. **Find** - Locates the card by short ID, UUID, or name
 2. **Move** - Moves the card to "In Progress" column
 3. **Label** - Adds the "agent" label to indicate AI is working
-4. **Track** - Starts a session timer visible in the UI
-5. **Implement** - Work on the task with progress updates
-6. **Complete** - Move to "Review" when done
+4. **Assign** - Auto-assigns the card to you (if `userEmail` is configured)
+5. **Track** - Starts a session timer visible in the UI
+6. **Implement** - Work on the task with progress updates
+7. **Complete** - Move to "Review" when done
 
 ## CLI Commands
 
 ```bash
-harmony-mcp configure          # Set up API key
-harmony-mcp init               # Initialize for AI agents (interactive)
-harmony-mcp init --all         # Configure all supported agents
-harmony-mcp init --detect      # Auto-detect and configure installed agents
-harmony-mcp init --agent X Y   # Configure specific agents
-harmony-mcp init -w WS -p PROJ # Initialize with local workspace/project context
-harmony-mcp status             # Show current config (global and local)
-harmony-mcp reset              # Clear configuration
-harmony-mcp set-workspace ID   # Set active workspace (global)
-harmony-mcp set-workspace ID -l # Set active workspace (local project)
-harmony-mcp set-project ID     # Set active project (global)
-harmony-mcp set-project ID -l  # Set active project (local project)
-harmony-mcp serve              # Start MCP server
+harmony-mcp configure                 # Set up API key (interactive)
+harmony-mcp configure -k KEY -e EMAIL # Set up with API key and email
+harmony-mcp init                      # Initialize for AI agents (interactive)
+harmony-mcp init --all                # Configure all supported agents
+harmony-mcp init --detect             # Auto-detect and configure installed agents
+harmony-mcp init --agent X Y          # Configure specific agents
+harmony-mcp init -w WS -p PROJ        # Initialize with local workspace/project context
+harmony-mcp status                    # Show current config (global and local)
+harmony-mcp reset                     # Clear configuration
+harmony-mcp set-workspace ID          # Set active workspace (global)
+harmony-mcp set-workspace ID -l       # Set active workspace (local project)
+harmony-mcp set-project ID            # Set active project (global)
+harmony-mcp set-project ID -l         # Set active project (local project)
+harmony-mcp set-user-email EMAIL      # Set email for auto-assignment
+harmony-mcp clear-user-email          # Disable auto-assignment
+harmony-mcp serve                     # Start MCP server
 ```
 
 ## Available Tools
@@ -245,10 +253,27 @@ Your global configuration is stored in `~/.harmony-mcp/config.json`:
   "apiKey": "hmy_...",
   "apiUrl": "https://gethmy.com/api",
   "activeWorkspaceId": null,
-  "activeProjectId": null
+  "activeProjectId": null,
+  "userEmail": "you@example.com"
 }
 ```
 
+### Auto-Assignment
+
+When `userEmail` is configured, cards are automatically assigned to you when you start an agent session (e.g., via `/hmy #42`). This helps track who is working on what.
+
+To enable auto-assignment:
+```bash
+harmony-mcp set-user-email you@example.com
+```
+
+To disable auto-assignment:
+```bash
+harmony-mcp clear-user-email
+```
+
+The email must match your Harmony account email to work correctly.
+
 ### Local Project Configuration
 
 For multi-project workflows, you can set project-specific context using local configuration. This is stored in `.harmony-mcp.json` in your project root:
@@ -287,6 +312,7 @@ Example output:
 Status: Configured
 API Key: hmy_abc1...
 API URL: https://gethmy.com/api
+User Email: y***@example.com
 
 Global Context:
   Workspace: <global-ws-id>

package/dist/cli.js

@@ -25251,7 +25251,8 @@ function loadConfig() {
       apiKey: null,
       apiUrl: DEFAULT_API_URL,
       activeWorkspaceId: null,
-      activeProjectId: null
+      activeProjectId: null,
+      userEmail: null
     };
   }
   try {
@@ -25261,14 +25262,16 @@ function loadConfig() {
       apiKey: config2.apiKey || null,
       apiUrl: config2.apiUrl || DEFAULT_API_URL,
       activeWorkspaceId: config2.activeWorkspaceId || null,
-      activeProjectId: config2.activeProjectId || null
+      activeProjectId: config2.activeProjectId || null,
+      userEmail: config2.userEmail || null
     };
   } catch {
     return {
       apiKey: null,
       apiUrl: DEFAULT_API_URL,
       activeWorkspaceId: null,
-      activeProjectId: null
+      activeProjectId: null,
+      userEmail: null
     };
   }
 }
@@ -25327,6 +25330,13 @@ function getApiUrl() {
   const config2 = loadConfig();
   return config2.apiUrl;
 }
+function getUserEmail() {
+  const config2 = loadConfig();
+  return config2.userEmail;
+}
+function setUserEmail(email2) {
+  saveConfig({ userEmail: email2 });
+}
 function setActiveWorkspace(workspaceId, options) {
   if (options?.local) {
     saveLocalConfig({ workspaceId }, options.cwd);
@@ -26521,6 +26531,21 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
         const cardId = exports_external.string().uuid().parse(args.cardId);
         const agentIdentifier = exports_external.string().min(1).parse(args.agentIdentifier);
         const agentName = exports_external.string().min(1).parse(args.agentName);
+        let assignedTo = null;
+        const userEmail = getUserEmail();
+        if (userEmail) {
+          try {
+            const workspaceId = getActiveWorkspaceId();
+            if (workspaceId) {
+              const { members } = await client2.getWorkspaceMembers(workspaceId);
+              const user = members.find((m) => m.email === userEmail);
+              if (user) {
+                await client2.updateCard(cardId, { assigneeId: user.id });
+                assignedTo = user.email;
+              }
+            }
+          } catch {}
+        }
         const result = await client2.startAgentSession(cardId, {
           agentIdentifier,
           agentName,
@@ -26528,7 +26553,7 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
           currentTask: args.currentTask,
           estimatedMinutesRemaining: args.estimatedMinutesRemaining
         });
-        return { success: true, ...result };
+        return { success: true, assignedTo, ...result };
       }
       case "harmony_update_agent_progress": {
         const cardId = exports_external.string().uuid().parse(args.cardId);
@@ -26643,10 +26668,11 @@ program.command("serve").description("Start the MCP server (stdio transport)").a
   const server = new HarmonyMCPServer;
   await server.run();
 });
-program.command("configure").description("Configure the MCP server with your Harmony API key").option("-k, --api-key <key>", "API key (generate at gethmy.com → Settings → API Keys)").option("-u, --api-url <url>", "API URL (optional, for self-hosted instances)").action(async (options) => {
+program.command("configure").description("Configure the MCP server with your Harmony API key").option("-k, --api-key <key>", "API key (generate at gethmy.com → Settings → API Keys)").option("-u, --api-url <url>", "API URL (optional, for self-hosted instances)").option("-e, --user-email <email>", "Your email for auto-assignment when starting agent sessions").action(async (options) => {
   try {
     let apiKey = options.apiKey;
     let apiUrl = options.apiUrl;
+    let userEmail = options.userEmail;
     if (!apiKey) {
       console.log(`Configure Harmony MCP Server
 `);
@@ -26663,10 +26689,16 @@ program.command("configure").description("Configure the MCP server with your Har
     if (apiUrl) {
       config2.apiUrl = apiUrl;
     }
+    if (userEmail) {
+      config2.userEmail = userEmail;
+    }
     saveConfig(config2);
     console.log(`
 Configuration saved successfully!`);
     console.log(`Config file: ${getConfigPath()}`);
+    if (userEmail) {
+      console.log(`User email: ${userEmail}`);
+    }
     console.log(`
 You can now use the MCP server with Claude Code.`);
     console.log(`Add this to your ~/.claude/settings.json:
@@ -26690,10 +26722,17 @@ program.command("status").description("Show configuration status").action(() =>
   const globalConfig2 = loadConfig();
   const localConfig = loadLocalConfig();
   const hasLocal = hasLocalConfig();
+  const maskEmail = (email2) => {
+    const [local, domain] = email2.split("@");
+    if (!domain)
+      return email2;
+    return `${local[0]}***@${domain}`;
+  };
   if (isConfigured()) {
     console.log("Status: Configured");
     console.log(`API Key: ${globalConfig2.apiKey?.slice(0, 8)}...`);
     console.log(`API URL: ${globalConfig2.apiUrl}`);
+    console.log(`User Email: ${globalConfig2.userEmail ? maskEmail(globalConfig2.userEmail) : "(not set)"}`);
     console.log(`
 Global Context:`);
     console.log(`  Workspace: ${globalConfig2.activeWorkspaceId || "(not set)"}`);
@@ -26728,7 +26767,8 @@ program.command("reset").description("Remove stored configuration").action(() =>
   saveConfig({
     apiKey: null,
     activeWorkspaceId: null,
-    activeProjectId: null
+    activeProjectId: null,
+    userEmail: null
   });
   console.log("Configuration reset successfully");
 });
@@ -26752,6 +26792,22 @@ program.command("set-project <projectId>").description("Set the active project c
     console.log(`Global project set to: ${projectId}`);
   }
 });
+program.command("set-user-email <email>").description("Set your email for auto-assignment when starting agent sessions").action((email2) => {
+  if (!email2.includes("@") || !email2.includes(".")) {
+    console.error("Error: Invalid email format");
+    process.exit(1);
+  }
+  setUserEmail(email2);
+  console.log(`User email set to: ${email2}`);
+  console.log(`
+Cards will be automatically assigned to you when starting agent sessions.`);
+});
+program.command("clear-user-email").description("Clear the configured user email (disables auto-assignment)").action(() => {
+  setUserEmail(null);
+  console.log("User email cleared");
+  console.log(`
+Auto-assignment is now disabled.`);
+});
 program.command("init").description("Initialize Harmony MCP for AI coding agents (Claude Code, Codex, Cursor, Windsurf)").option("-a, --agent <agents...>", `Agent(s) to configure: ${SUPPORTED_AGENTS.join(", ")}`).option("--all", "Configure all supported agents").option("--detect", "Auto-detect installed agents and configure them").option("-f, --force", "Overwrite existing configuration files").option("-d, --directory <path>", "Project directory (default: current directory)").option("-w, --workspace <id>", "Set local workspace context for this project").option("-p, --project <id>", "Set local project context for this project").action(async (options) => {
   console.log(`Harmony MCP Initialization
 `);

package/dist/index.js

@@ -23013,7 +23013,8 @@ function loadConfig() {
       apiKey: null,
       apiUrl: DEFAULT_API_URL,
       activeWorkspaceId: null,
-      activeProjectId: null
+      activeProjectId: null,
+      userEmail: null
     };
   }
   try {
@@ -23023,14 +23024,16 @@ function loadConfig() {
       apiKey: config2.apiKey || null,
       apiUrl: config2.apiUrl || DEFAULT_API_URL,
       activeWorkspaceId: config2.activeWorkspaceId || null,
-      activeProjectId: config2.activeProjectId || null
+      activeProjectId: config2.activeProjectId || null,
+      userEmail: config2.userEmail || null
     };
   } catch {
     return {
       apiKey: null,
       apiUrl: DEFAULT_API_URL,
       activeWorkspaceId: null,
-      activeProjectId: null
+      activeProjectId: null,
+      userEmail: null
     };
   }
 }
@@ -23089,6 +23092,13 @@ function getApiUrl() {
   const config2 = loadConfig();
   return config2.apiUrl;
 }
+function getUserEmail() {
+  const config2 = loadConfig();
+  return config2.userEmail;
+}
+function setUserEmail(email2) {
+  saveConfig({ userEmail: email2 });
+}
 function setActiveWorkspace(workspaceId, options) {
   if (options?.local) {
     saveLocalConfig({ workspaceId }, options.cwd);
@@ -24283,6 +24293,21 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
         const cardId = exports_external.string().uuid().parse(args.cardId);
         const agentIdentifier = exports_external.string().min(1).parse(args.agentIdentifier);
         const agentName = exports_external.string().min(1).parse(args.agentName);
+        let assignedTo = null;
+        const userEmail = getUserEmail();
+        if (userEmail) {
+          try {
+            const workspaceId = getActiveWorkspaceId();
+            if (workspaceId) {
+              const { members } = await client2.getWorkspaceMembers(workspaceId);
+              const user = members.find((m) => m.email === userEmail);
+              if (user) {
+                await client2.updateCard(cardId, { assigneeId: user.id });
+                assignedTo = user.email;
+              }
+            }
+          } catch {}
+        }
         const result = await client2.startAgentSession(cardId, {
           agentIdentifier,
           agentName,
@@ -24290,7 +24315,7 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
           currentTask: args.currentTask,
           estimatedMinutesRemaining: args.estimatedMinutesRemaining
         });
-        return { success: true, ...result };
+        return { success: true, assignedTo, ...result };
       }
       case "harmony_update_agent_progress": {
         const cardId = exports_external.string().uuid().parse(args.cardId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harmony-mcp",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "type": "module",
   "main": "dist/index.js",