harmony-mcp 1.3.0 → 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,23 +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 status             # Show current config
-harmony-mcp reset              # Clear configuration
-harmony-mcp set-workspace ID   # Set active workspace
-harmony-mcp set-project ID     # Set active 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
@@ -233,17 +244,97 @@ curl -X GET "https://gethmy.com/api/workspaces" \
 
 ## Configuration
 
-Your configuration is stored in `~/.harmony-mcp/config.json`:
+### Global Configuration
+
+Your global configuration is stored in `~/.harmony-mcp/config.json`:
 
 ```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:
+
+```json
+{
+  "workspaceId": "uuid-here",
+  "projectId": "uuid-here"
+}
+```
+
+**Priority**: Local config overrides global config for workspace and project context.
+
+**Security**: API key is never stored locally (only in global config) to prevent accidental commits.
+
+#### Setting Local Context
+
+```bash
+# During initialization
+harmony-mcp init --workspace <ws-id> --project <proj-id>
+
+# Or separately
+harmony-mcp set-workspace <id> --local
+harmony-mcp set-project <id> --local
+```
+
+#### Viewing Configuration
+
+```bash
+harmony-mcp status
+```
+
+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>
+  Project: <global-proj-id>
+
+Local Context (.harmony-mcp.json):
+  Workspace: <local-ws-id>
+  Project: <local-proj-id>
+
+Active (effective):
+  Workspace: <local-ws-id>  ← local
+  Project: <local-proj-id>  ← local
+```
+
+#### Recommended .gitignore
+
+Add this to prevent accidentally committing local config:
+
+```
+.harmony-mcp.json
+```
+
 ## Architecture
 
 ```

package/dist/cli.js

@@ -25234,12 +25234,16 @@ import { homedir as homedir2 } from "node:os";
 import { join as join2 } from "node:path";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 var DEFAULT_API_URL = "https://gethmy.com/api";
+var LOCAL_CONFIG_FILENAME = ".harmony-mcp.json";
 function getConfigDir() {
   return join2(homedir2(), ".harmony-mcp");
 }
 function getConfigPath() {
   return join2(getConfigDir(), "config.json");
 }
+function getLocalConfigPath(cwd) {
+  return join2(cwd || process.cwd(), LOCAL_CONFIG_FILENAME);
+}
 function loadConfig() {
   const configPath = getConfigPath();
   if (!existsSync2(configPath)) {
@@ -25247,7 +25251,8 @@ function loadConfig() {
       apiKey: null,
       apiUrl: DEFAULT_API_URL,
       activeWorkspaceId: null,
-      activeProjectId: null
+      activeProjectId: null,
+      userEmail: null
     };
   }
   try {
@@ -25257,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
     };
   }
 }
@@ -25278,6 +25285,39 @@ function saveConfig(config2) {
   const newConfig = { ...existingConfig, ...config2 };
   writeFileSync2(configPath, JSON.stringify(newConfig, null, 2), { mode: 384 });
 }
+function loadLocalConfig(cwd) {
+  const localConfigPath = getLocalConfigPath(cwd);
+  if (!existsSync2(localConfigPath)) {
+    return null;
+  }
+  try {
+    const data = readFileSync2(localConfigPath, "utf-8");
+    const config2 = JSON.parse(data);
+    return {
+      workspaceId: config2.workspaceId || null,
+      projectId: config2.projectId || null
+    };
+  } catch {
+    return null;
+  }
+}
+function saveLocalConfig(config2, cwd) {
+  const localConfigPath = getLocalConfigPath(cwd);
+  const existingConfig = loadLocalConfig(cwd) || {
+    workspaceId: null,
+    projectId: null
+  };
+  const newConfig = { ...existingConfig, ...config2 };
+  const cleanConfig = {};
+  if (newConfig.workspaceId)
+    cleanConfig.workspaceId = newConfig.workspaceId;
+  if (newConfig.projectId)
+    cleanConfig.projectId = newConfig.projectId;
+  writeFileSync2(localConfigPath, JSON.stringify(cleanConfig, null, 2));
+}
+function hasLocalConfig(cwd) {
+  return existsSync2(getLocalConfigPath(cwd));
+}
 function getApiKey() {
   const config2 = loadConfig();
   if (!config2.apiKey) {
@@ -25290,16 +25330,39 @@ function getApiUrl() {
   const config2 = loadConfig();
   return config2.apiUrl;
 }
-function setActiveWorkspace(workspaceId) {
-  saveConfig({ activeWorkspaceId: workspaceId });
+function getUserEmail() {
+  const config2 = loadConfig();
+  return config2.userEmail;
+}
+function setUserEmail(email2) {
+  saveConfig({ userEmail: email2 });
 }
-function setActiveProject(projectId) {
-  saveConfig({ activeProjectId: projectId });
+function setActiveWorkspace(workspaceId, options) {
+  if (options?.local) {
+    saveLocalConfig({ workspaceId }, options.cwd);
+  } else {
+    saveConfig({ activeWorkspaceId: workspaceId });
+  }
+}
+function setActiveProject(projectId, options) {
+  if (options?.local) {
+    saveLocalConfig({ projectId }, options.cwd);
+  } else {
+    saveConfig({ activeProjectId: projectId });
+  }
 }
-function getActiveWorkspaceId() {
+function getActiveWorkspaceId(cwd) {
+  const localConfig = loadLocalConfig(cwd);
+  if (localConfig?.workspaceId) {
+    return localConfig.workspaceId;
+  }
   return loadConfig().activeWorkspaceId;
 }
-function getActiveProjectId() {
+function getActiveProjectId(cwd) {
+  const localConfig = loadLocalConfig(cwd);
+  if (localConfig?.projectId) {
+    return localConfig.projectId;
+  }
   return loadConfig().activeProjectId;
 }
 function isConfigured() {
@@ -26468,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,
@@ -26475,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);
@@ -26590,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
 `);
@@ -26610,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:
@@ -26634,19 +26719,43 @@ You can now use the MCP server with Claude Code.`);
   }
 });
 program.command("status").description("Show configuration status").action(() => {
-  const config2 = loadConfig();
+  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: ${config2.apiKey?.slice(0, 8)}...`);
-    console.log(`API URL: ${config2.apiUrl}`);
-    if (config2.activeWorkspaceId) {
-      console.log(`Active Workspace: ${config2.activeWorkspaceId}`);
-    }
-    if (config2.activeProjectId) {
-      console.log(`Active Project: ${config2.activeProjectId}`);
+    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)"}`);
+    console.log(`  Project: ${globalConfig2.activeProjectId || "(not set)"}`);
+    if (hasLocal) {
+      console.log(`
+Local Context (${getLocalConfigPath()}):`);
+      console.log(`  Workspace: ${localConfig?.workspaceId || "(not set)"}`);
+      console.log(`  Project: ${localConfig?.projectId || "(not set)"}`);
     }
+    const effectiveWorkspace = getActiveWorkspaceId();
+    const effectiveProject = getActiveProjectId();
+    console.log(`
+Active (effective):`);
+    const wsSource = localConfig?.workspaceId ? "local" : globalConfig2.activeWorkspaceId ? "global" : "";
+    const projSource = localConfig?.projectId ? "local" : globalConfig2.activeProjectId ? "global" : "";
+    console.log(`  Workspace: ${effectiveWorkspace || "(not set)"}${wsSource ? `  ← ${wsSource}` : ""}`);
+    console.log(`  Project: ${effectiveProject || "(not set)"}${projSource ? `  ← ${projSource}` : ""}`);
     console.log(`
-Config file: ${getConfigPath()}`);
+Global config: ${getConfigPath()}`);
+    if (hasLocal) {
+      console.log(`Local config: ${getLocalConfigPath()}`);
+    }
   } else {
     console.log("Status: Not configured");
     console.log(`
@@ -26658,19 +26767,48 @@ program.command("reset").description("Remove stored configuration").action(() =>
   saveConfig({
     apiKey: null,
     activeWorkspaceId: null,
-    activeProjectId: null
+    activeProjectId: null,
+    userEmail: null
   });
   console.log("Configuration reset successfully");
 });
-program.command("set-workspace <workspaceId>").description("Set the active workspace context").action((workspaceId) => {
-  setActiveWorkspace(workspaceId);
-  console.log(`Active workspace set to: ${workspaceId}`);
+program.command("set-workspace <workspaceId>").description("Set the active workspace context").option("-l, --local", "Save to local project config (.harmony-mcp.json) instead of global").action((workspaceId, options) => {
+  const isLocal = options.local;
+  setActiveWorkspace(workspaceId, { local: isLocal });
+  if (isLocal) {
+    console.log(`Local workspace set to: ${workspaceId}`);
+    console.log(`Config file: ${getLocalConfigPath()}`);
+  } else {
+    console.log(`Global workspace set to: ${workspaceId}`);
+  }
 });
-program.command("set-project <projectId>").description("Set the active project context").action((projectId) => {
-  setActiveProject(projectId);
-  console.log(`Active project set to: ${projectId}`);
+program.command("set-project <projectId>").description("Set the active project context").option("-l, --local", "Save to local project config (.harmony-mcp.json) instead of global").action((projectId, options) => {
+  const isLocal = options.local;
+  setActiveProject(projectId, { local: isLocal });
+  if (isLocal) {
+    console.log(`Local project set to: ${projectId}`);
+    console.log(`Config file: ${getLocalConfigPath()}`);
+  } else {
+    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("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)").action(async (options) => {
+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
 `);
   let agents = [];
@@ -26768,6 +26906,19 @@ ${result.agent.toUpperCase()}:`);
       console.log("  No changes made");
     }
   }
+  if (options.workspace || options.project) {
+    console.log(`
+LOCAL CONTEXT:`);
+    if (options.workspace) {
+      saveLocalConfig({ workspaceId: options.workspace }, cwd);
+      console.log(`  ✓ Workspace: ${options.workspace}`);
+    }
+    if (options.project) {
+      saveLocalConfig({ projectId: options.project }, cwd);
+      console.log(`  ✓ Project: ${options.project}`);
+    }
+    console.log(`  Config file: ${getLocalConfigPath(cwd)}`);
+  }
   console.log(`
 ` + "─".repeat(60));
   if (!isConfigured()) {

package/dist/index.js

@@ -22996,12 +22996,16 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 var DEFAULT_API_URL = "https://gethmy.com/api";
+var LOCAL_CONFIG_FILENAME = ".harmony-mcp.json";
 function getConfigDir() {
   return join(homedir(), ".harmony-mcp");
 }
 function getConfigPath() {
   return join(getConfigDir(), "config.json");
 }
+function getLocalConfigPath(cwd) {
+  return join(cwd || process.cwd(), LOCAL_CONFIG_FILENAME);
+}
 function loadConfig() {
   const configPath = getConfigPath();
   if (!existsSync(configPath)) {
@@ -23009,7 +23013,8 @@ function loadConfig() {
       apiKey: null,
       apiUrl: DEFAULT_API_URL,
       activeWorkspaceId: null,
-      activeProjectId: null
+      activeProjectId: null,
+      userEmail: null
     };
   }
   try {
@@ -23019,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
     };
   }
 }
@@ -23040,6 +23047,39 @@ function saveConfig(config2) {
   const newConfig = { ...existingConfig, ...config2 };
   writeFileSync(configPath, JSON.stringify(newConfig, null, 2), { mode: 384 });
 }
+function loadLocalConfig(cwd) {
+  const localConfigPath = getLocalConfigPath(cwd);
+  if (!existsSync(localConfigPath)) {
+    return null;
+  }
+  try {
+    const data = readFileSync(localConfigPath, "utf-8");
+    const config2 = JSON.parse(data);
+    return {
+      workspaceId: config2.workspaceId || null,
+      projectId: config2.projectId || null
+    };
+  } catch {
+    return null;
+  }
+}
+function saveLocalConfig(config2, cwd) {
+  const localConfigPath = getLocalConfigPath(cwd);
+  const existingConfig = loadLocalConfig(cwd) || {
+    workspaceId: null,
+    projectId: null
+  };
+  const newConfig = { ...existingConfig, ...config2 };
+  const cleanConfig = {};
+  if (newConfig.workspaceId)
+    cleanConfig.workspaceId = newConfig.workspaceId;
+  if (newConfig.projectId)
+    cleanConfig.projectId = newConfig.projectId;
+  writeFileSync(localConfigPath, JSON.stringify(cleanConfig, null, 2));
+}
+function hasLocalConfig(cwd) {
+  return existsSync(getLocalConfigPath(cwd));
+}
 function getApiKey() {
   const config2 = loadConfig();
   if (!config2.apiKey) {
@@ -23052,16 +23092,39 @@ function getApiUrl() {
   const config2 = loadConfig();
   return config2.apiUrl;
 }
-function setActiveWorkspace(workspaceId) {
-  saveConfig({ activeWorkspaceId: workspaceId });
+function getUserEmail() {
+  const config2 = loadConfig();
+  return config2.userEmail;
+}
+function setUserEmail(email2) {
+  saveConfig({ userEmail: email2 });
 }
-function setActiveProject(projectId) {
-  saveConfig({ activeProjectId: projectId });
+function setActiveWorkspace(workspaceId, options) {
+  if (options?.local) {
+    saveLocalConfig({ workspaceId }, options.cwd);
+  } else {
+    saveConfig({ activeWorkspaceId: workspaceId });
+  }
 }
-function getActiveWorkspaceId() {
+function setActiveProject(projectId, options) {
+  if (options?.local) {
+    saveLocalConfig({ projectId }, options.cwd);
+  } else {
+    saveConfig({ activeProjectId: projectId });
+  }
+}
+function getActiveWorkspaceId(cwd) {
+  const localConfig = loadLocalConfig(cwd);
+  if (localConfig?.workspaceId) {
+    return localConfig.workspaceId;
+  }
   return loadConfig().activeWorkspaceId;
 }
-function getActiveProjectId() {
+function getActiveProjectId(cwd) {
+  const localConfig = loadLocalConfig(cwd);
+  if (localConfig?.projectId) {
+    return localConfig.projectId;
+  }
   return loadConfig().activeProjectId;
 }
 function isConfigured() {
@@ -24230,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,
@@ -24237,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.0",
+  "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",