HubSpot MCP Server

Instructions

🎯 Purpose:
  1. This tool retrieves detailed information about a specific workflow from the HubSpot account.

🧭 Usage Guidance:
  1. Use the "flowId" parameter to specify which workflow to retrieve.
  2. This endpoint returns complete workflow information including actions, enrollment criteria, and scheduling.
  3. Use the hubspot-list-workflows tool first to identify the workflow ID you need.

Implementation Reference

• dist/tools/workflows/getWorkflowTool.js:34-57 (handler)

  The handler function that executes the core logic of the tool by calling the HubSpot API to retrieve workflow details for the given flowId.

  async process(args) {
      try {
          const response = await this.client.get(`/automation/v4/flows/${args.flowId}`);
          return {
              content: [
                  {
                      type: 'text',
                      text: JSON.stringify(response, null, 2),
                  },
              ],
          };
      }
      catch (error) {
          return {
              content: [
                  {
                      type: 'text',
                      text: `Error retrieving HubSpot workflow (ID: ${args.flowId}): ${error instanceof Error ? error.message : String(error)}`,
                  },
              ],
              isError: true,
          };
      }
  }

• dist/tools/workflows/getWorkflowTool.js:5-27 (schema)

  Input schema using Zod for validation of flowId parameter and the complete tool definition including name, description, and JSON schema conversion.

  const GetWorkflowSchema = z.object({
      flowId: z.string().describe('The ID of the workflow to retrieve'),
  });
  const ToolDefinition = {
      name: 'hubspot-get-workflow',
      description: `
      🎯 Purpose:
        1. This tool retrieves detailed information about a specific workflow from the HubSpot account.
  
      🧭 Usage Guidance:
        1. Use the "flowId" parameter to specify which workflow to retrieve.
        2. This endpoint returns complete workflow information including actions, enrollment criteria, and scheduling.
        3. Use the hubspot-list-workflows tool first to identify the workflow ID you need.
    `,
      inputSchema: zodToJsonSchema(GetWorkflowSchema),
      annotations: {
          title: 'Get HubSpot Workflow Details',
          readOnlyHint: true,
          destructiveHint: false,
          idempotentHint: true,
          openWorldHint: true,
      },
  };

• dist/tools/toolsRegistry.js:47-47 (registration)

  Registers an instance of the GetWorkflowTool in the central tools registry.

  registerTool(new GetWorkflowTool());