@hubspot/cli 7.7.9-experimental.0 → 7.7.11-experimental.0

package/commands/mcp/setup.d.ts

@@ -1,8 +1,9 @@
 import { ArgumentsCamelCase, Argv } from 'yargs';
 interface MCPSetupArgs {
     targets?: string[];
+    addDocsSearch?: boolean;
 }
-declare function handler(argv: ArgumentsCamelCase<MCPSetupArgs>): Promise<void>;
+declare function handler(args: ArgumentsCamelCase<MCPSetupArgs>): Promise<void>;
 declare const _default: {
     command: string[];
     describe: undefined;

package/commands/mcp/setup.js

@@ -20,27 +20,33 @@ const describe = undefined; // Leave hidden for now
 const execAsync = (0, util_1.promisify)(child_process_1.exec);
 const claudeCode = 'claude-code';
 const claudeDesktop = 'claude-desktop';
+const windsurf = 'windsurf';
 const cursor = 'cursor';
 const mcpServerName = 'hubspot-cli-mcp';
 const supportedTools = [
     { name: en_1.commands.mcp.setup.claudeCode, value: claudeCode },
     // { name: commands.mcp.setup.claudeDesktop, value: claudeDesktop },
     { name: en_1.commands.mcp.setup.cursor, value: cursor },
+    { name: en_1.commands.mcp.setup.windsurf, value: windsurf },
 ];
 const hsCommand = 'hs';
 const mcpCommandArgs = ['mcp', 'start'];
 function setupBuilder(yargs) {
-    yargs.option('targets', {
+    yargs
+        .option('targets', {
         describe: en_1.commands.mcp.setup.args.targets,
         type: 'array',
         choices: [...supportedTools.map(tool => tool.value)],
+    })
+        .option('add-docs-search', {
+        type: 'boolean',
     });
     return yargs;
 }
 const builder = (0, yargsUtils_1.makeYargsBuilder)(setupBuilder, command, describe, {
     useGlobalOptions: true,
 });
-async function handler(argv) {
+async function handler(args) {
     try {
         await import('@modelcontextprotocol/sdk/server/mcp.js');
     }
@@ -48,7 +54,22 @@ async function handler(argv) {
         logger_1.uiLogger.error(en_1.commands.mcp.setup.errors.needsNode20);
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    await addMcpServerToConfig(argv.targets);
+    await addMcpServerToConfig(args.targets);
+    if (args.addDocsSearch) {
+        logger_1.uiLogger.info(en_1.commands.mcp.setup.installingDocSearch);
+        await new Promise(() => {
+            const childProcess = (0, child_process_1.spawn)(`npx`, ['mint-mcp', 'add', 'hubspot-migration'], {
+                stdio: 'inherit',
+            });
+            childProcess.on('exit', code => {
+                if (code !== 0) {
+                    process.exit(exitCodes_1.EXIT_CODES.ERROR);
+                }
+                process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+            });
+        });
+    }
+    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
 }
 async function addMcpServerToConfig(targets) {
     try {
@@ -80,6 +101,9 @@ async function addMcpServerToConfig(targets) {
         if (derivedTargets.includes(cursor)) {
             await runSetupFunction(setupCursor);
         }
+        if (derivedTargets.includes(windsurf)) {
+            await runSetupFunction(setupWindsurf);
+        }
         logger_1.uiLogger.info(en_1.commands.mcp.setup.success(derivedTargets));
     }
     catch (error) {
@@ -95,7 +119,7 @@ async function runSetupFunction(func) {
         process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
 }
-async function setupClaudeDesktop() {
+function setupClaudeDesktop() {
     try {
         const configPath = getClaudeDesktopConfigPath();
         SpinniesManager_1.default.add('claudeDesktop', {
@@ -196,7 +220,7 @@ async function setupClaudeCode() {
         return false;
     }
 }
-async function setupCursor() {
+function setupCursor() {
     try {
         SpinniesManager_1.default.add('cursor', {
             text: en_1.commands.mcp.setup.spinners.configuringCursor,
@@ -237,7 +261,7 @@ async function setupCursor() {
     }
     catch (error) {
         SpinniesManager_1.default.fail('cursor', {
-            text: en_1.commands.mcp.setup.spinners.failedToConfigure,
+            text: en_1.commands.mcp.setup.spinners.failedToConfigureCursor,
         });
         (0, errorHandlers_1.logError)(error);
         return false;
@@ -254,4 +278,51 @@ function getClaudeDesktopConfigPath() {
         return path_1.default.join(homeDir, '.config', 'claude', 'claude_desktop_config.json');
     }
 }
+function setupWindsurf() {
+    try {
+        SpinniesManager_1.default.add('cursor', {
+            text: en_1.commands.mcp.setup.spinners.configuringWindsurf,
+        });
+        const windsurf = path_1.default.join(os_1.default.homedir(), '.codeium', 'windsurf', 'mcp_config.json');
+        if (!fs_1.default.existsSync(windsurf)) {
+            SpinniesManager_1.default.succeed('cursor', {
+                text: en_1.commands.mcp.setup.spinners.noWindsurfFile(windsurf),
+            });
+            return false;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let config = {};
+        // Read existing config
+        try {
+            const configContent = fs_1.default.readFileSync(windsurf, 'utf8');
+            config = JSON.parse(configContent);
+        }
+        catch (error) {
+            (0, errorHandlers_1.logError)(error);
+            return false;
+        }
+        // Initialize mcpServers if it doesn't exist
+        if (!config.mcpServers) {
+            config.mcpServers = {};
+        }
+        // Add or update HubSpot CLI MCP server
+        config.mcpServers[mcpServerName] = {
+            command: hsCommand,
+            args: mcpCommandArgs,
+        };
+        // Write the updated config
+        fs_1.default.writeFileSync(windsurf, JSON.stringify(config, null, 2));
+        SpinniesManager_1.default.succeed('cursor', {
+            text: en_1.commands.mcp.setup.spinners.configuredWindsurf,
+        });
+        return true;
+    }
+    catch (error) {
+        SpinniesManager_1.default.fail('cursor', {
+            text: en_1.commands.mcp.setup.spinners.failedToConfigureWindsurf,
+        });
+        (0, errorHandlers_1.logError)(error);
+        return false;
+    }
+}
 exports.default = { command, describe, builder, handler };

package/lang/en.d.ts

@@ -766,11 +766,14 @@ Global configuration replaces hubspot.config.yml, and you will be prompted to mi
     };
     readonly mcp: {
         readonly setup: {
+            readonly installingDocSearch: "Adding the docs-search mcp server, please follow the prompt";
             readonly claudeCode: "Claude Code";
             readonly claudeDesktop: "Claude Desktop";
             readonly cursor: "Cursor";
+            readonly windsurf: "Windsurf";
             readonly args: {
                 readonly targets: "Target applications to configure";
+                readonly docsSearch: "Should the docs search mcp server be installed";
             };
             readonly success: (derivedTargets: string[]) => string;
             readonly errors: {
@@ -790,6 +793,10 @@ Global configuration replaces hubspot.config.yml, and you will be prompted to mi
                 readonly failedToConfigureCursor: "Failed to configure Cursor";
                 readonly configuredCursor: "Configured Cursor";
                 readonly alreadyInstalled: "HubSpot CLI mcp server already installed, reinstalling";
+                readonly configuringWindsurf: "Configuring Cursor...";
+                readonly noWindsurfFile: (configFile: string) => string;
+                readonly failedToConfigureWindsurf: "Failed to configure Cursor";
+                readonly configuredWindsurf: "Configured Windsurf";
             };
             readonly prompts: {
                 readonly targets: "[--targets] Which tools would you like to add the HubSpot CLI MCP server to?";

package/lang/en.js

@@ -778,11 +778,14 @@ exports.commands = {
     },
     mcp: {
         setup: {
+            installingDocSearch: 'Adding the docs-search mcp server, please follow the prompt',
             claudeCode: 'Claude Code',
             claudeDesktop: 'Claude Desktop',
             cursor: 'Cursor',
+            windsurf: 'Windsurf',
             args: {
                 targets: 'Target applications to configure',
+                docsSearch: 'Should the docs search mcp server be installed',
             },
             success: (derivedTargets) => `You can now use the HubSpot CLI tools in ${derivedTargets.join(', ')}.  ${chalk_1.default.bold('You may need to restart these tools to apply the changes')}.`,
             errors: {
@@ -802,6 +805,10 @@ exports.commands = {
                 failedToConfigureCursor: 'Failed to configure Cursor',
                 configuredCursor: 'Configured Cursor',
                 alreadyInstalled: 'HubSpot CLI mcp server already installed, reinstalling',
+                configuringWindsurf: 'Configuring Cursor...',
+                noWindsurfFile: (configFile) => `No ${configFile} file found - skipping Windsurf configuration`,
+                failedToConfigureWindsurf: 'Failed to configure Cursor',
+                configuredWindsurf: 'Configured Windsurf',
             },
             prompts: {
                 targets: '[--targets] Which tools would you like to add the HubSpot CLI MCP server to?',

package/lib/middleware/configMiddleware.js

@@ -40,6 +40,7 @@ async function injectAccountIdMiddleware(argv) {
 const SKIP_CONFIG_VALIDATION = {
     init: { target: true },
     auth: { target: true },
+    mcp: { target: true },
 };
 async function loadConfigMiddleware(argv) {
     // Skip this when no command is provided
@@ -105,6 +106,7 @@ const configSubCommands = {
 const SKIP_ACCOUNT_VALIDATION = {
     init: { target: true },
     auth: { target: true },
+    mcp: { target: true },
     account: accountsSubCommands,
     accounts: accountsSubCommands,
     sandbox: sandboxesSubCommands,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/cli",
-    "version": "7.7.9-experimental.0",
+    "version": "7.7.11-experimental.0",
     "description": "The official CLI for developing on HubSpot",
     "license": "Apache-2.0",
     "repository": "https://github.com/HubSpot/hubspot-cli",