@hubspot/cli 7.7.0-experimental.1 → 7.7.0-experimental.2

package/mcp-server/tools/UploadProjectTool.js

@@ -8,7 +8,7 @@ class UploadProjectTool extends MCPTool {
     schema = {
         projectPath: {
             type: z.string().optional(),
-            description: 'Path to the project directory. Defaults to current directory',
+            description: 'Path to the project directory. When using MCP server globally, provide the absolute path to your project (e.g., "/Users/yourname/projects/my-hubspot-project"). Defaults to "." for local usage.',
         },
         accountId: {
             type: z.string().optional(),
@@ -20,8 +20,8 @@ class UploadProjectTool extends MCPTool {
         },
     };
     async execute(input) {
-        // Default to current working directory, which should be where Cursor is running from
-        const { projectPath = process.cwd(), accountId, autoInstallCLI = false, } = input;
+        // Default to current directory "." which should resolve relative to where the MCP client is running
+        const { projectPath = '.', accountId, autoInstallCLI = false } = input;
         try {
             // Step 1: Check if HubSpot CLI is installed
             const cliCheckResult = await this.cliHelper.checkCLIInstallation();
@@ -110,6 +110,8 @@ class UploadProjectTool extends MCPTool {
             else {
                 // Parse upload failure
                 const errorOutput = uploadResult.output || uploadResult.error || 'Upload failed';
+                // Check if this looks like a path issue with global MCP server
+                const isPathIssue = errorOutput.includes('Unable to locate a project configuration file') || errorOutput.includes('MCP Server CWD: /');
                 return {
                     status: 'upload-failed',
                     message: '❌ Project upload failed',
@@ -123,12 +125,23 @@ class UploadProjectTool extends MCPTool {
                         'Ensure you have network connectivity to HubSpot',
                         'Try uploading to a different account if you have access to multiple',
                         `Working directory was: ${projectPath}`,
+                        ...(isPathIssue
+                            ? [
+                                '⚠️  PATH ISSUE DETECTED: You may be using the global MCP server',
+                                'When using global MCP server, provide the absolute path to your project:',
+                                'Example: {"projectPath": "/Users/yourname/projects/my-hubspot-project"}',
+                                'Or consider running the MCP server locally from your project directory',
+                            ]
+                            : []),
                     ],
                     nextSteps: [
                         '1. Check authentication status: hs auth info',
                         '2. Validate project first: hs project validate',
-                        '3. Review the error output above for specific issues',
-                        '4. Try the upload command again after fixing issues',
+                        ...(isPathIssue
+                            ? ['3. Provide absolute projectPath if using global MCP server']
+                            : []),
+                        '4. Review the error output above for specific issues',
+                        '5. Try the upload command again after fixing issues',
                     ],
                 };
             }

package/mcp-server/tools/ValidateProjectTool.js

@@ -12,12 +12,12 @@ class ValidateProjectTool extends MCPTool {
         },
         projectPath: {
             type: z.string().optional(),
-            description: 'Path to the project directory. Defaults to current directory',
+            description: 'Path to the project directory. When using MCP server globally, provide the absolute path to your project (e.g., "/Users/yourname/projects/my-hubspot-project"). Defaults to "." for local usage.',
         },
     };
     async execute(input) {
-        // Default to current working directory, which should be where Cursor is running from
-        const { autoFix = false, projectPath = process.cwd() } = input;
+        // Default to current directory "." which should resolve relative to where the MCP client is running
+        const { autoFix = false, projectPath = '.' } = input;
         try {
             // Step 1: Check if HubSpot CLI is installed
             const cliCheckResult = await this.cliHelper.checkCLIInstallation();
@@ -101,6 +101,18 @@ class ValidateProjectTool extends MCPTool {
                 if (!isValid && output.includes('Project validation failed:')) {
                     errors.push(...this.parseValidationErrors(output));
                 }
+                // Add debugging information about directory context
+                if (result.output.includes('Unable to locate a project configuration file')) {
+                    errors.push(`Working directory was: ${projectPath}`);
+                    errors.push("Make sure you're running this from a directory containing hsproject.json");
+                    // Check if this looks like a global MCP server path issue
+                    if (result.output.includes('MCP Server CWD: /')) {
+                        errors.push('⚠️  PATH ISSUE DETECTED: You may be using the global MCP server');
+                        errors.push('When using global MCP server, provide the absolute path to your project:');
+                        errors.push('Example: {"projectPath": "/Users/yourname/projects/my-hubspot-project"}');
+                        errors.push('Or consider running the MCP server locally from your project directory');
+                    }
+                }
                 return {
                     isValid: isValid,
                     output: output,

package/package.json

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